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PREFACE 



MANUAL OBJECTIVES 

The RSX-11M/M-PLUS Command Language Manual provides information needed 
to use a terminal to do work on an RSX-11M/M-PLUS system. Important 
system concepts are introduced and explained in the context of the 
DIGITAL Command Language (DCL) . DCL is a user-oriented command 
language with English words and prompting for required command 
elements. 



INTENDED AUDIENCE 

This manual is intended for any user of an RSX-11M/M-PLUS system. The 
manual is a reference manual with many tutorial elements, but new 
users should read the Introduction to RSX-11M and RSX-11M-PLUS first. 

A user is anyone who interfaces with the system to perform some task. 

There are two kinds of users: privileged and nonprivileged. 
Privileged users have access to functions that control and modify 
system operation as well as functions that permit program development 
and system maintenance. Nonprivileged users have access to functions 
required for program development and local maintenance only. 



STRUCTURE OP THE DOCUMENT 

The manual is organized around the major operating system functions. 
Following the introduction, each major function has a chapter to 
itself. All commands relating to the function are described in the 
chapter. The last chapter is an annotated alphabetical listing of all 
DCL commands. 

Chapter 1 introduces the basic concepts of DCL and explains how DCL is 
implemented on RSX-11M/M-PLUS, as well as including many hints on 
using DCL. The chapter includes summaries of the remainder of the 
manual, and other introductory and summary material about DCL, the 
operating system, and various utilities and system tasks. 

Chapter 2 lists the most common forms of SET and SHOW commands. 

Chapter 3 covers terminal operations, including logging in and logging 
out, keyboard terminology and functions, setting and displaying 
terminal attributes, broadcasting messages, and using the system HELP 
commands. 
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PREFACE 

Chapter 4 introduces file-handling operations on RSX-llM/M-PLUS, 
including commands to create and delete files, list directories, and 
rename, copy, type, and print files. Wildcards and defaults are 
explained . 

Chapter 5 covers peripheral devices and introduces the system I/O 
terminology. The chapter explains the relations between hardware 
devices and the software file system, and describes how to prepare 
scratch disks and magnetic tapes for use on the system. Commands 
affecting devices and software volumes are described. 

Chapter 6 introduces the program-development facilities of the system 
and the DCL commands used with these facilities. 

Chapter 7 explains how tasks run in the system, how they are named, 
installed, fixed in memory, and controlled while running. In 
addition, commands to abort tasks, to place tasks in the clock queue, 
and to display information about tasks in the system are described. 

Chapter 8 covers the DCL system-control commands. 

Chapter 9 is the alphabetical listing of all DCL commands and their 
formats, including comments to remind you of specific points about 
many commands and command elements. Each entry in Chapter 9 includes 
a cross-reference to the full command description in an earlier 
chapter. Chapter 9 is marked by a blue tab for quick reference. 

Appendix A explains error messages common to several DCL commands. 
Other command-specific error messages are explained in the full 
command descriptions. 

Appendix B lists the relations between DCL and the rest of the 
operating system. 

Appendix C is a Summary of Technical Changes. This appendix lists all 
the command syntax that has changed or been added to DCL since 
RSX-11M-PLUS VI. 0. These changes are extensive. 



ASSOCIATED DOCUMENTS 

Other documents related to RSX-llM/M-PLUS are described in the 
RSX-11M/RSX-11S Information Directory and Index . 

Other documents related to RSX-llM/M-PLUS are described in the 
RSX-11M-PLUS Information Directory and Index . 

If you are entirely new to computers or to DCL, you should read the 
Introduction to RSX-11M and RSX-11M-PLUS and follow through as 
instructed there. 

Although this manual is meant to be self-contained, you will find 
important information in the RSX-llM/M-PLUS MCR Operations Manual and 
the RSX-llM/M-PLUS Utilities Manual . 

Programmers should see the RSX-llM/M-PLUS Guide to Program 
Development . 
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CONVENTIONS USED IN THIS DOCUMENT 

A number of conventions are used in the command descriptions in this 
manual : 



Convention 



Meanina 



The vertical ellipsis denotes elements of command 
input without relevance to the point being 
discussed. 



[/qualifier] 



[grin] 



UPPERCASE 



lowercase 



/qualifier 



parameter 



:argument 



Any command field enclosed in brackets is 
optional. If the brackets include syntactical 
elements, such as dots (.) or slashes (/) , those 
elements are required for the field. If the field 
appears in lowercase, you are to substitute a 
legal command element if you include the field. 

This signifies either a User Identification Code 
(UIC) or a User File Directory (UFD) . The g is a 
group number and the m is a member number. Where 
a UIC or UFD is required, only one set of brackets 
is shown, as [g,m] . Where the UIC or UFD is 
optional, two sets of brackets are shown, as 
[[g,m]]. The UIC identifies a user. The UFD 
identifies a directory. 

Any comand field in uppercase indicates that you 
should type the word or letter exactly as shown. 

Any command field in lowercase is to be 
substituted for. Usually the lowercase word 
identifies the kind of substitution expected. 

Any command element preceded by a slash (/) is a 
DCL qualifier, Command qualifiers alter the 
action of a command they are attached to. 
Parameter qualifiers modify the action of the 
command as it affects that parameter. 

Required command fields are generally called 
parameters. The most common parameters are file 
specifications. Parameters are preceded by blanks 
or DCL prompts. 

Some parameters and qualifiers can be altered by 
the inclusion of arguments preceded by a colon. 
Arguments can be either numerical or alphabetical. 
The equal sign (=) can be substituted for the 
colon to introduce arguments. 
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Convention Meaning 

filespec A full file specification includes device, UFD, 

file name, file type, and version number, as in 
this example: 

DB1: [303,5]HIPPITY.HOP;2 

Full filespecs are rarely needed. If you do not 
give a version number, the highest numbered 
version will be used. If you do not give a UFD, 
the default UFD will be used. Some system 
functions default to particular file types. See 
Chapter 4 for more information on file 
specifications. See also the individual command 
descriptions. 

Some commands accept a filespec with a DECnet node 
name. See Chapter 1 for more information. 

red ink All user input in examples is printed in red ink. 

(ret) An oval symbol with a 2- to 6-character 

abbreviation indicates that you are to press the 
corresponding key on your terminal. For example, 
RET indicates that you are to press the RETURN 
key, and DEL means that you are to press the 
DELETE key. 

( Ctrl a ! The oval symbol CTRL/a means that you are to press 

the key marked CTRL while simultaneously pressing 

another key. Thus, CTRL/Z indicates that you are 

to press the CTRL key and the Z key 

simultaneously. This is echoed on your terminal 
as "Z. Not all CTRL characters echo. See Chapter 
3 for more information. 

pink shading Text shaded in pink describes the RSX-llM 

Operating System only. 

gray shading Text shaded in gray describes the RSX-11M-PLUS 

Operating System only. 

See Chapter 1 for more information on DCL conventions. 
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CHAPTER 1 
INTRODUCTION 



DCL is the DIGITAL Command Language. DCL provides RSX-11M/M-PLUS 
users with an extensive set of commands for interactive program 
development, device and file manipulation, and interactive program 
execution and control. 

If you are new to computers, or if you wish a quick review of DCL and 
the operating system, you should read the Introduction to RSX-11M and 
RSX-11M-PLUS . This manual includes a guided tour of the operating 
system, including an interactive terminal session that introduces all 
of the most commonly used DCL commands. 

DCL commands are full words that describe the action to be taken, not 
abbreviations or mnemonics. Thus, if you wish to set a terminal to 
lowercase, you type SET TERMINAL/LOWERCASE. Because DCL commands and 
command elements are full words, they are self-documenting. 

You are not required to use the full form of DCL commands at the 
terminal, however. Usually, you need type only the command elements 
required to form a unique command. For instance, SE TE/LOW will also 
set a terminal to lowercase, but SE TE/LO will not work because there 
is also a command SET TERMINAL/LOCAL. See Section 1.2 for more 
information on how DCL commands are parsed. 



1.1 RSX-11M/M-PLUS AND DCL: BASIC CONCEPTS 

RSX-11M/M-PLUS systems may have one or more command line interpreters 
(CLIs) . All systems include MCR (the Monitor Console Routine) . Many 
systems also include DCL, and some systems include other CLIs. Both 
MCR and DCL include commands to invoke most system tasks and utilities 
and to set and display certain system characteristics. In general, 
MCR commands name tasks, such as PIP, a utility used to manipulate 
files (for example, to copy or type them), while DCL commands specify 
actions directly, as in the COPY command or the TYPE command. 

MCR is the fundamental command line interpreter (CLI) for the 

dov_i lu/u nriTO r\v^^-^-»+--J«« c?t.#-.4- rt — ,-. \Arr> -i~„ , — -:j~~ 3-, j — .u 

and display certain system characteristics. MCR provides the most 
direct interface with the operating system, either RSX-11M or 
RSX-11M-PLUS. 

In general, MCR commands must be entered in exact syntax. MCR 
commands follow no set syntax rules, however. Most MCR commands are 
terse abbreviations or mnemonics. 

DCL is an optional user-oriented CLI included in most systems with 
many users. Commands in DCL are English-like words and follow 
well-defined syntax rules. Full commands are self-documenting. DCL 
is designed for consistency and ease of use. 
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INTRODUCTION 

DCL is based on the command languages used on a number of DIGITAL 
operating systems. In particular, RSX-11M/M-PLUS DCL is designed for 
compatibility with future releases of VAX/VMS DCL. See Section 1.7 
for more information on DCL compatibility. 

DCL on RSX-11M and RSX-11M-PLUS systems is a CLI task that translates 
DCL commands into MCR commands for execution by the system. The DCL 
SET DEBUG command displays the MCR translation for any DCL command on 
your terminal. See Section 1.2.15 for more information on the SET 
DEBUG command. 

Depending on the kind of use you make of your system and the nature of 
your system, you may find it more convenient to use one CLI or the 
other, or both. All nonpr ivileged system functions are available 
directly from DCL, but some privileged functions are not. All 
program-development facilities and all common utility functions are 
available from DCL. 

Because RSX-11M and RSX-11M-PLUS are designed to be tailored to the 
needs of each installation, not every feature of DCL described in this 
manual is available on every system. Some DCL commands depend on 
layered products that may not be available at your installation. Many 
features, particularly on RSX-11M systems, are system-generation 
options that may not have been selected at the time your system was 
generated. Shaded text indicates that the feature is available on 
only one system. You should see your system manager or another 
knowledgeable system user if some feature described in this manual 
does not appear to be available at your installation. 



1.2 THE DCL COMMAND LINE 
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system is to take. Most commands also include one or more parameters 
and qualifiers to further define the action of the command. 
Qualifiers are preceded by a slash (/) and parameters are preceded by 
a space. Both qualifiers and parameters can take arguments. 
Arguments are preceded by a colon (:). 

Commands are passed to the operating system with a terminator, either 
RETURN or ESC. (The ESC key may be labeled SEL or ALT MODE. Its 
action differs from that of the RETURN key in that the cursor does not 
return to the left margin and no monitor prompt is returned after 
execution is completed.) 

Unless the action of the RETURN differs greatly from what is expected, 
the examples and command formats in this manual do not include an 
indication that each line in the command is terminated by a carriage 
return. (See Section 1.2.13, for a discussion of command lines too 
long to fit on one line of your terminal.) 

Some commands require parameters or arguments as part of the command 
line. If you fail to supply a required command element, DCL prompts 
you with one or two words indicating the general nature of the 
required element. If you do not understand the prompt, type a 
question mark (?) for help. (In some cases, an omission causes an 
error rather than a prompt.) 

Section 1.2.1 discusses prompting in detail. 

This section introduces the rules governing the use of DCL. The 
examples in this section are intended to illustrate these rules, not 
to illustrate the full capabilities of the command. For more detail, 
see the individual command descriptions. 
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1.2.1 Prompting 

The prompts teach you the form of a command by requesting that you 
supply required command elements. 

For example, the RENAME command works as follows: 

>RENAME 

From? BROWNS. STL 

To? ORIOLES. BLT 

The one-line format for RENAME is: 
>RENAME BROWNS. STL ORIOLES. BLT 

The formats can be mixed. DCL prompts for whatever you leave out. 
For example: 

>RENAME BROWNS. STL. 
To? ORIOLES. BLT 

There are no defaults for prompts. You must supply a response to any 

j~t±. wiuf »- • j- j- yyJKj. uu iiw i- wibii t»o ^uuLiiiuc WiLii uliS v^ uiTiiLici ilQ r Lypc a 

CTRL/Z. 



1.2.2 Qualifiers 

Qualifiers modify the action of the command. Qualifiers always start 
with a slash (/) and are generally optional. 

Qualifiers are either command qualifiers or parameter qualifiers. 

Most qualifiers are command qualifiers. In this manual, command 

qualifiers are always shown as modifying the command verb, as in this 
example: 

>TYPE/TODAY *,HLP 

However, most command qualifiers can appear anywhere in the command 
line. Another name for these qualifiers is floating qualifiers. The 
following examples illustrate how command qualifiers can float: 

>TYPE *.HLF'/T0DAY 
or 

>TYPE 

Filets)? *.HLP/TQDAY 

or 

> T Y r E 

File(s)? /TODAY 

File(s)? K.HLP 

You can mix formats, as in the following example: 

>TYPE/TODAY 

Filets)? * . HLP/EXCLUDE I HELPF . HLP i * 

or 
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>TYPE/TODAY 

File(s)? *.HLP/ 

Qualifier? EXCLUDE JHELPF , HLP 5 * 

or 

>TYPE/TODAY 

File<s>? / 

Qualifier? EXCLUDES HELPF , HLP J U 

File(s)? *.HLP 

Note that you are prompted for a qualifier when a slash with no 
qualifier attached appears on t^ * command line. When you supply the 
qualifier, do not type the slash ,ain. 

Regardless of where the qualifier appears, it has the same effect. 

Almost all command qualifiers can float in this way. In a few cases, 
the command qualifier must appear directly after the command it 
modifies. Whenever two similar commands are described separately, 
such as ASSIGN and ASSIGN/REDIRECT or CREATE and CREATE/DIRECTORY, the 
distinguishing qualifier cannot float. Other qualifiers to such 
commands can still float, however, as in this example: 

>CREATE/DIRECTORY 

Device; UFD? C303 r 5H/ALL0CATI0N 15 

which is the same as 

>CRE ATE/DIRECTORY/ ALLOC AT I ON! 5 C303»53 

Qualifiers described as parameter qualifiers, or filespec qualifiers, 
cannot float. Most DCL parameters are filespecs. 

Parameter qualifiers do not modify the action of the command; they 
modify the action of the command as it concerns that particular 
parameter or supply additional information needed for the command to 
execute properly. For instance, in the following example: 

>MACR0 HIYA> TESTBLD/LI BRARY , PIGEON 

the qualifier /LIBRARY identifies a particular file as being a 
library. Obviously, /LIBRARY could not float. 

If, however, a command has parameter qualifiers that are identical to 
command qualifiers, you may find confusing results from floating 
qualifiers . 

For instance, the PRINT command has both the command qualifier /COPIES 
and the parameter qualifier /COPIES. For instance, if you attach the 
/COPIES qualifier to the PRINT command, as shown below: 

>PRINT/C0PIESI2 OZY.TXT 

then two copies of the file are queued for printing. 

You can include more than one file in a PRINT command. Each file 
specified is a parameter to the PRINT command, although only the first 
file is a required parameter. The command 

>PRINT OZY.TXT, IZZY . TXT/COP IES t 2 

includes the parameter qualifier /COPIES: 2. The command causes one 
copy of OZY.TXT to be printed, which is the default, and two copies of 
IZZY. TXT to be printed because the default was overridden. 
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Many qualifiers can be negated by prefixing NO or - (minus) to the 
qualifier name. Thus, the command 

>MACRO/QBJECT SIMPLE. MAC 

directs the MACRO-11 Assembler to make an object file, while the 
command 

>MACRO/N0OBJECT SIMPLE. MAC 

or 

>MACRQ/-OBJECT SIMPLE. MAC 

directs the MACRO-11 Assembler to oii,:?t the object file. In the first 
example, /OBJECT is the default qualifier and need not be explicitly 
included. In other words, unless your MACRO command includes the 
/NOOBJECT qualifier, an object file is produced. 



1.2.3 HELP 

HELP is available from the system for all DCL commands and also for 

many other aspects of the system. You can get help through the HELP 

command or by typing a question mark (?) in response to any DCL 

prompt. 

For instance, if you wish help on the TYPE command, type the 
following: 

>HELP TYPE 
I YPEC/aualif ierCs33 f ilespecCsH 
/DATEtdd-mmm-yy 
/SINCEtdd-mmm-yy 
/THROUGHJdd-mnim-yy 

/S I NCEtdd-mmm-uy /THROUGH : dd-mmm-yy 
/TODAY 
/EXCLUBEtf ilespec 

The TYPE command displays the contents of text files on your 
t e r m i r 1 3 3. * 



The HELP text consists of a brief explanation of the command followed 
by an illustration of the syntax, showing that TYPE accepts one or 
more filespecs, and one or more qualifiers. See Section 4.4.1 for 
more information on TYPE and its qualifiers. Or, type a HELP command 
naming the qualifier to get more information on that qualifier. 

>HELP TYPE TODAY 

TYPE/TODAY filespecCsl 

The /TODAY aualifier specifies that you wish the TYPE command to 
type only files created today. 
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If you wish help while being prompted by the TYPE command, use the 
following procedure: 

>TYPE 

File(s)? ? 
TYPEC/QU3lifierCsD] filespecCs3 

/DATE * dd-mniiri-ay 

/SINCE!dd-mmm-yy 

/THROUGH idd-mmm-yy 

/SINCE:dd--n.mni-ay/THR0UGH5dd-nimiii~yy 

/TODAY 

/EXCLUDE. f ilespec 

The TYPE command displays the contents of te:;t files on your 
terminal . 

F i 1 e < s ) ? 

The same help text is printed on your terminal, but the prompt 
returns, meaning the TYPE command is still waiting for you to list the 
files you wish typed. 

You can also get help on a specific subtopic while being prompted by a 
command by responding to the prompt with a question mark. For 
example : 

>SET 

Function? ? 
SET thins! 

The SET command can be used to set something* The following 
things can be set with this command* 

CDAY3TIME DEBUG DEFAULT DEVICE GROUPFLAGS 

LIBRARY CN03PARTITION PRIORITY PROTECTION QUEUE 
SYSTEM TERMINAL 

For information on the BET ACCOUNTING command? see HELP 
ACCOUNTING SET* 

To get help on a specific thing, enter a question mark followed by the 
thing : 

Function? ? DEFAULT 

SET DEFAULT Cddnn , 1 C Cuf 61 1 

The SET DEFAULT command sets your default directory or device > 
a r b o t h ♦ 

SET DEFAULT with no parameters returns a nonpr i vi leged user to 
the login device and UFD. For privileged users* the unadorned 
SET DEFAULT returns to the login device? but the UFD remains the 
s a m e . 

Function? ? 

You can also get help by typing a question mark in response to the 
system prompt (>) and to the explicit DCL prompt (DCL>) . 

If you should decide after reading the help text that you have chosen 

the wrong command, enter a CTRL/Z in response to the prompt to end the 

execution of the command. (A CTRL/Z in response to a prompt always 
cancels execution of a DCL command.) 
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From a DCL terminal, the command HELP provides information on DCL and 
the command HELP/MCR provides information on MCR. The command HELP 
SHOW provides information on the DCL SHOW command, and HELP SHOW 
TERMINAL provides information on the DCL SHOW TERMINAL command. 

From an MCR terminal, the command HELP provides information on MCR and 
the command HELP/DCL provides information on DCL. 

There may also be special help files providing information on special 
aspects of your installation. In addition, you can create local help 
files for your own use. 

See Section 3.5 for more information on the HELP command and help 
files . 



1.2.4 MCR and DCL Commands 

You can usually enter MCR commands from terminals set to DCL or DCL 
commands from terminals set to MCR. 

If you are at a DCL terminal and wish to enter an MCR command, simply 
precede the command with an MCR. The command is passed directly to 
MCR while the terminal remains set to DCL. 

Here is the format of the MCR command: 

DCL>MCR 

MCR command line? mcrcommand 



DCL>MCR mcrcommand 

And, if you wish to enter a DCL command from an MCR terminal, use the 
DCL command. The command is executed and the terminal remains set to 
MCR. Here is the format of the DCL command: 

MCR>DCL dclcommand 

There are no prompts from this command. 



1.2.5 Abbreviations 

It is rarely necessary for you to type either the complete command 
name or the complete qualifier name. You only need to type the 
characters needed to distinguish the command or qualifier from all 
others . 

For example: 

• TYPE can be abbreviated T because it is the only command 
beginning with that character. 

• INITIALIZE can be abbreviated INI, but not IN. 

• INSTALL can be abbreviated INS, but not IN. 

Three letters will usually be enough. Four letters will always be 
enough. You can often omit other parts of commands as well. You 
should experiment to find how short various commands can be cut. 
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Command 


Brief Form 


Command 


ABORT 


A 


HELP 


BROADCAST 


B 


HELP 


copy 


C 


LOGOUT 


DIRECTORY 


D 


LINK 


DEALLOCATE 


DEA 


MACRO 


DEASSIGN 


DEAS 


PRINT 


EDIT 


E 


RUN 


FORTRAN 


F 


SHOW 



For instance, the command 
>SET TERMINAL/VT52 

is the documented format for the command that sets a terminal as a 
VT52. The same command to VAX/VMS DCL does the same thing. However, 
the RSX-11M/M-PLUS version of DCL permits you to type the following 

>SE VT52 

to achieve the same result. 

These briefer forms should be used interactively only, and not used 
when you are making a permanent record or creating an indirect command 
file (or batch job). You should also see Section 1.6.1 for a 
discussion of compatibility between RSX-llM/M-PLUS DCL and other 

versions r>f DCT. listed r,n r>(-Vi<=r- o >"> ^ ■>-=><- i "^ <-,r=4-~™.5 

For your convenience, some frequently used commands have brief forms. 
These are: 

Brief Form 

H 
■p 

LO 

L 
M 
P 
R 
S 

These shortened forms replace the command verbs for entering commands. 

See the Note in Section 1.6.1 on support for brief command formats. 

1.2.6 Numbers and Dates 

DCL recognizes both octal and decimal numbers. You usually do not 
have to identify a number as octal or decimal. All numbers are 
recognized as being octal or decimal, unless otherwise noted. 

DCL recognizes dates in two forms: 

dd-mmm-yy as in 21-JAN-82 
or 

mm/dd/yy as in 1/21/82 
System displays are always in the first format. 

1.2.7 Multiple Parameters 

Some commands permit you to enter a single filespec or other parameter 
by a list of parameters. If you are entering a list of parameters, 
each parameter must be set off by commas. For example: 

>PRINT ALPHA, TXT 
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causes a single file to be printed, while 

/.PRINT ALPHA* TXT; BETA, TXT? GAMMA.TXT 

causes three files to be printed. You have the option of including 
blanks on either side of the comma in lists. 

If you end the list with a comma, DCL prompts you for further 
parameters. For instance, 

>PRINT ALPHA. TXT f BETA, TXT? 
File(s)? GAMMA.TXT 

Some commands accept a list of arguments to a single qualifier or 
parameter. In such cases, the list of arguments must be enclosed in 
parentheses, with each element set off by commas. For example: 

>MACR0/SH0U; < CALLS » COMMENTS) HIYA 

If you need to enter only a single argument, you do not need the 
parentheses. For example: 

> M A C R / S H W t C A L L S H I Y A 



1.2.8 Dnderscore Character 

The underscore character (_) is used to make DCL commands more 
readable where two words are needed to name a single command element, 
such as PRINT/FLAG_PAGE. However, you need not type the underscore to 
enter the command. PRINT/FLAGPAGE is the same as PRINT/FLAG_PAGE. 



1.2.9 Colon and Equal Sign 

The command descriptions in this manual show arguments set off by a 
colon ( : } , such as 

>PR INT/COPIES J 2 IZZY.TXT 

You can always replace such colons with an equal sign (=) , as in this 
example: 

/.PRINT /COPIES = 2 IZZY.TXT 

Colons in device names, such as DB1:, and so forth, cannot be replaced 
by equal signs. 



1.2.10 Quoting Strings 

If you wish to include an exact string in a DCL command, put the 
string in quotes. For instance, the message 

>BROADCAST/ALL Rock 3nd roll will never die 

is broadcast as 

ll-DEC-82 il',55 From PRINCE J t WRITERS (TT645) to ALL 

ROCK AND ROLL WILL NEVER DIE 
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while 

>BROADCAST/ALL 'Rock and roll will never die* 

is broadcast as 

ll-DEC-82 13; 56 From PRINCE : I WRITERS (TT64t) to ALL 

"Rock and roll will never die" 

You also need quotes when passing commands to tasks using the 
/PARAMETERS qualifier to MOUNT or the /COMMAND qualifier to RUN or 
INSTALL. 



1.2.11 ANSI File Names 

ANSI file names do not have the same format as Files-11 file names and 
may contain characters that are illegal in Files-11. For instance, 
""MONEY$."" is a legal ANSI file name, as is ""CASH$."". To use those 
file names in a command, simply enter them as shown in the following 
example: 

; COPY 

From? MM: " "HONEY*. " " 

To? HMi; ' "CASH*. " ' 

If you are copying a file from a tape to a Files-11 disk, however, you 
must use only Radix-50 file specifications, such as 

>C0PY 

From'? hMJ " "MONEY*. " * 

To? DBt C200r 1 "J R AH TX50.TXT 

The Radix-50 character set consists of the numbers through 9, the 
letters of the alphabet, the dollar sign ($) and the period (.). 



1.2.12 DECnet and DCL 

Some commands will accept DECnet node names as part of a filespec. 
They are: 

APPEND DELETE 
COPY DIRECTORY 
CREATE TYPE 

If the node you name has a DECnet default account, you can simply add 
the node name to the filespec in the following fashion: 

>TYPE PRINCE: JDB2SC303f53R0MAN.TXT 

All the usual rules about file and volume protection are maintained, 
of course. 

If the node you name has named directories, you must enclose the 
filespec in quotes, as shown: 

>TYPE EEETEEt t " DISKtUSERDISK J E BALTQN3DESPERAD0 . DIS " 
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1^2.13 Command Line Continuation 

The hyphen (-) is used to indicate line continuation. When you end a 
command line with a hyphen and a carriage return, the DCL continuation 
prompt (->) indicates that you can continue entering the command line. 
If you are continuing a line from a prompt, such as Task? that prompt 
is the indication that the line is being continued. 

This feature permits you to enter command lines including more 
characters than your terminal has room for on one line. 

Most DCL commands are limited to 250 characters in all. No command 
line can be longer than 250 characters. 

Here is an example of line continuation: 

>PRINT/C0PIESi2/LENGTH:60/FLAGPAGE/AFTER: (04-JUL-80) QZY.TXT,- (RET) 
-O-IZZY.TXT. FIZZY.TXT (ret) 

The command is not entered until DCL encounters a line ending with a 
carriage return not preceded by a hyphen. In the example, the first 
carriage return does not enter the command. Only the second carriage 
return enters the command. The carriage return can be on a line by 
itself . 

NOTE 

RSX-ilM-PLUS supports Line continuation 
for both MCR and DCL. 

RSX-11M supports line continuation for 

DCL only. Therefore, it is possible for 

a DCL command on RSX-11M to translate to 
an MCR line that is too long for the 

system to handle. n such cases', you 

should'"; examine. the' command to find- 

unnecessary c.J cinentv , such as defaults 

"that ' '''need - i. not ■■- ... be " " specified , '; ' or 

qua 1 i f i er s . tha t . .' co u Id ., , "be '".'." enter ed 

-separately ■'..,, wi thout defeating "■'"your 

purpose. ^ ■ ■::,*"■ 



1.2.14 Comments in Command Lines 

You can include comments in a DCL command line with the exclamation 
point ( ! ) . 

If the comment ends the command line, only a single exclamation point 
is needed, as in this example: 

>PRINT OZY.TXT (Poem by Shelley 

If the comment is within the command line, two exclamation points are 
needed, as in this example 

>PRINT!Paroda of Shelley! IZZY.TXT 

These comments are ignored and not interpreted in any way by DCL. 

Comments can be placed at any natural break in the command line: 
between qualifiers, between parameters, even as part of a response to 
a prompt. 
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Another example: 

> PRINT/FORMS! 2 ! Letter— Quality printer! IZZY .TXT 

You may want to include comments when you are keeping a permanent 
record of a terminal session. 

1.2.15 SET DEBUG 

SET DEBDG displays the MCR translation of any DCL command. 

Format 

SET [NO]DEBUG[/qualifier [s] ] 

Command Qualifiers 

/[NO] EXECUTE 
/FULL 

Command Qualifiers 

/[NO] EXECUTE 

The /EXECUTE qualifier indicates that you wish the DCL command to 
execute after the translation is displayed. The default is 
/NOEXECUTE, meaning that the translation only is displayed. When 
SET DEBUG/NOEXECUTE is in effect, you can only issue SET DEBUG 
commands or MCR commands using the DCL MCR command; all other 
DCL commands are trapped and translated. You can issue SET 
NODEBUG to turn off SET DEBUG. You can also issue SET DEBUG with 
either /FULL or /EXECUTE or both. 



/FULL 



The /FULL qualifier indicates that you wish SET DEBUG to display 
the logical symbols (IFORM queue) used by DCL to translate the 
command as well as the translation itself. See the 
RSX-11M/M-PLUS System Management Guide for information on how DCL 
uses these logical symbols. 



Examples 



>SET DEBUG 
>SH0W TIME 
TIM 

> INITIALIZE/EXTENSION 5 200/F'ROTECT ION! < SYS i RWED , OWN J RUED , GRO , WO ) 

Device? DK2 

Label? HOTROD 

INI DK2:H0TR0D/EXT=200./PRQ=CRWEDiRWED» , 1 

>SET DEBUG/EXECUTE 

>S TIM 

TIM 

21J33M6 ll-DEC-82 

>SET NODEBUG 



In this example, the user first issued SET DEBUG. Then the user 
typed SHOW TIME. DCL displayed TIM, which is the MCR command to 
display the date and time, but no date and time is displayed 
because /NOEXECUTE was in effect. Then the user typed an 
INITIALIZE command and DCL displayed the MCR translation of the 
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same command. Then the user typed SET DEBUG/EXECUTE and typed 
SHOW TIME again. This time, after displaying the MCR command 
TIM, DCL passed the command TIM to MCR and the date and time were 
displayed. Finally, the user typed SET NODEBUG to end session 
with SET DEBUG. 



Notes 



Use SET DEBUG to check on the MCR syntax of any DCL command. 
This is particularly helpful when learning the brief forms of 
commands . 

SET DEBUG creates your own copy of DCL that remains present while 
SET DEBUG is in effect. Therefore, SET DEBUG creates a load on 
the system. You should use SET DEBUG sparingly, particularly 
when the system is under heavy use. 



1.2.16 Errors 

You can correct typing errors or change the line completely, by using 
the RUBOUT or DELETE key, or CTRL/U (provided you have not terminated 
the line) . 

You can cancel the execution of any DCL command by typing a CTRL/Z. 

If the system detects an error in the command line input, it returns 
the appropriate error message at the issuing terminal. 

Here are some examples of incorrect commands and the error messages 
they produce: 

>PRIJT IZZY.TXT 

DCL - - 1 1 1 e 3 3 1 command 

;•■ F R I N T / P U R P L E I Z Z Y .TXT 

PRINT -- Illegal or contradictory Qualifier 

PRINT/PURPLE IZZY.TXT 



>PRINT/COPIES J TWELVE IZZY.TXT 
PRINT -- Numeral expected 
PR INT /COPIES; TWELVE IZZY.TXT 

In the first case, the error was detected by DCL, as indicated by the 
first part of the error message. There is no DCL PRUT command. The 
entire command was rejected. 

In the second case, the command was entered correctly, but the 
qualifier was incorrect. The first part of the message shows that the 
error was detected within the PRINT command itself. The command is 
reprinted and a circumflex {") points to the error. 

In the third case, the command and qualifier were correct, but the 
argument was in error. The message explains the error and the 
circumflex points to the error. 

Sometimes the circumflex does not point directly at the error, but at 
the point at which the command started to go wrong, which may be 
several characters before the actual error. 
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Typing mistakes are by far the most common cause of errors. Retyping 
the command often eliminates the error. Other common causes of error? 
are omitting a space or other delimiter in a command line, "" ' 



The command descriptions include the most common errors produced by 
the commands and suggestions for correcting the errors. All the DCL 
error messages are listed and explained in Appendix A of this manual. 
In some cases, such as file-system errors, you may need to go to 
another manual for explanation of the error or seek help from a 
knowledgeable system user. 



1.3 FUNCTIONAL GROUPING OF DCL COMMANDS 

This manual includes seven functional groupings of commands, each 
grouping constituting a chapter. Each of these chapters is described 
here. Fully detailed descriptions of each command are included in 
these functional chapters. The functional groupings of commands are 
described in Sections 1.3.1 through 1.3.7. Each functional chapter 
also includes an introduction to the important concepts of the 
functional group. 

Command descriptions can have five parts: 

• Brief statement of the function of the command. 

• Full description of the format of the command, including 
prompts, defaults, acceptable values for arguments, and the 
effects of each qualifier. 

• Examples of the command in use. These examples often 
illustrate less obvious aspects of the use of the command. 

• Notes, including warnings about side effects, counteracting 
commands, recommendations for further reading, and so forth. 

• Error messages, including an explanation and a suggested user 
action for each error. 

All command descriptions start with the function and the format. Most 
include at least one example. In some cases, there are no notes. 
Only error messages specific to the command are included in the 
command descriptions. General error messages, such as those relating 
to syntax, are described in Appendix A. 

The full command description includes all these parts. In particular, 
you should read the examples carefully. Often the examples clarify 
points made in the format descriptions. 

In addition, the format of each DCL command is presented in the 
alphabetical listing in Chapter 9 of this manual. 

DCL commands cover the full range of nonprivileged commands. 
Nonprivileged commands are those commands needed in everyday use of 
the system by all users. Many privileged commands are also included 
in DCL. Privileged commands are those commands that affect system 
operations. For instance, the SHOW TIME command is a nonprivileged 
command, but the SET TIME command is privileged. 
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1.3.1 The SET and SHOW Commands 

The SET commands dynamically alter system characteristics. The SHOW 
commands display system characteristics. These commands are 
introduced in Chapter 2. The most useful functions of SET and SHOW 
are also described in Chapter 2. However, because such a wide variety 
of functions can be altered or displayed, the remaining functions of 
SET and SHOW are listed in Chapter 2 but described in the appropriate 
functional chapter. SET and SHOW are the last commands described in 
each chapter. For example, SET DEVICES and SHOW DEVICES are described 
in full at the end of Chapter 5, "Handling Devices and Volumes"; and 
SET TERMINAL and SHOW TERMINAL are described at the end of Chapter 3, 
"Terminal Operations." 

The SET or SHOW command and its function are considered to form a 

single command. That is, rather than referring to the TERMINAL 

function of the SHOW command, you would refer to the SHOW TERMINAL 
command . 



1.3.2 Terminal Operations 

All commands directly related to terminal operations are described in 
Chapter 3. The commands include LOGIN, LOGOUT, BROADCAST, REQUEST, 
HELP, SET TERMINAL, and SHOW TERMINAL. In addition, Chapter 3 
includes a detailed description of the use of the terminal keyboard on 
RSX-11M/M-PLUS systems. All control (CTRL) characters and other 
important keys are explained. 



1.3.3 Handling Files 

Most information in RSX-11M/M-PLUS systems is in files in User File 
Directories (UFDs) . These files and directories are located within 
Files-11 volumes. 

All commands relating to files are described in Chapter 4. 

The commands include CREATE, CREATE/DIRECTORY, EDIT, EDIT/EDT, 
EDIT/SLP, EDIT/KED, COPY, CONVERT, TYPE, PRINT, RENAME, DIRECTORY, 
DELETE, PURGE, SORT, APPEND, DIFFERENCES, and UNLOCK. 

SET and SHOW commands described in Chapter 4 include SET PROTECTION 
and SET and SHOW DEFAULT. 



1.3.4 Handling Devices and Volumes 

Volumes are held on magnetic media, usually disks. The volume is in 
the RSX-11M/M-PLUS format, called Files-11. The disks are mounted on 
hardware devices. Devices can be public, available to all users; 
shareable, available to some users but not others; or private, 
available to a single user only. 

All commands relating to volumes and devices are described in Chapter 
5. The commands include ALLOCATE, DEALLOCATE, ASSIGN, 
ASSIGN/REDIRECT, ASSIGN/TASK, DEASSIGN, MOUNT, DISMOUNT, INITIALIZE, 
INITIALIZE/UPDATE, and BACKUP. 



SET and SHOW commands described in Chapter 5 include SHOW 
and SET and SHOW DEVICES. 



ASSIGNMENTS 
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1.3.5 Program Development 

RSX-11M/M-PLUS provides full facilities for program development, which 
are described in Chapter 6. The commands described include MACRO, 
BASIC, COBOL, FORTRAN, LIBRARY, and LINK. 

SET GROUPFLAGS and SHOW GROUPFLAGS are also described. 



1.3.6 Running Tasks 

The task is the fundamental executable programming unit on 
RSX-11M/M-PLUS. All commands related to running tasks are described 
in Chapter 7. 

mK^c^ „^,y„», = r^<=! i ,-.^.1 ,-,Aa DriM AQAD1' fflHTTmiB, flMfEr., T HST a I".r. . RF.MfWR. 

FIX and UNFIX, and START, START/UNBLOCK and STOP/BLOCK. 

SET and SHOW commands described in Chapter 7 include SET and SHOW 
PARTITION, SHOW TASKS, SET PRIORITY, SHOW CLOCK_QUEUE, and SHOW 
COMMON . 



1.3.7 System Control 

System control commands are described in Chapter 8. Most of these 
commands are privileged, but the SHOW commands described in Chapter 8 
are nonpr i vileged . 

Only SET and SHOW commands are described in Chapter 8. These include 
SET and SHOW SYSTEM/DIRECTORY, SET and SHOW LIBRARY/DIRECTORY, SET and 
SHOW [DAY] TIME, SHOW MEMORY. SHOW USERS, SET and SHOW SYSTEM/POOL, and 
SET SYSTEM/ [NO] LOGINS. 



1.4 USING THE QUEUE MANAGER: PRINT AND BATCH JOBS 

The RSX-11M/M-PLUS Queue Manager provides facilities for printing 
files on line printers or other output devices. Files can be printed 
under user control or under the control of a system task or 
applications task. See the description of the PRINT command in 
Section 4.4.2. 

In, addition, , on RSX-llM-PLUS, the Queue, -Manager provides ■■ a 
batch-processing/ facility ,. : '■'■■■■■ .Batch gobs? use- the: system !i without 

requiring' you to be present * " ThijS means ; : that jobs that take a Ibng 

'time to run, or otherwise tie up system facilities.;, can be run when 
there are fewer demands on the system, such as at night or on 
weekends. 

All uses of the Queue Manager are described in a separate manual, the 
RSX-11M/M-PLUS Batch and Queue Operations Manual . The manual 
introduces and explains all the uses of the Queue Manager and the 
batch-processing subsystem. The manual includes sample print and 
batch jobs, full descriptions of commands to the batch processors, all 
commands for placing jobs in queues and displaying queue contents, and 
a complete description of the process of setting up the Queue Manager. 
In addition, the manual includes an explanation of writing tasks to 
spool output. 



1-16 



INTRODUCTION 



1.5 INDIRECT COMMAND FILES IN DCL 

In addition to the batch-processing subsystem, RSX-11M/M-PLUS provides 
the Indirect Command Processor (Indirect) as an alternative means of 
automatically passing commands to the operating system. If you have a 
series of commands to be executed in the same or similar fashion every 
time, you can include these commands in a file to be run by Indirect. 

Indirect accepts not only DCL and MCR commands, but also special 
directives that allow you to program the execution of the indirect 
command file. Indirect is described in full in the 
RSX-11M/RSX-11M/M-PLUS MCR Operations Manual . 

An indirect command file can include both MCR and DCL commands. If 
the file contains commands to both of these command line interpreters 
(CLIs) , you must either prefix each CLI command with the CLI name, or 
change the CLI setting of your terminal before each CLI command. When 
your file has completed, reset the terminal to your usual CLI in the 
indirect command file. For example, if your terminal is set to DCL 
and you have MCR commands in your indirect command file, you can 
prefix each MCR command with "MCR," or set the terminal to MCR before 
each command and then reset it to DCL afterwards. 



1.6 DCL AND RSX-11M/M-PLUS UTILITIES AND SYSTEM TASKS 

The RSX-11M/M-PLUS Operating System includes a number of utilities and 
other system tasks designed to assist you in your use of the system. 
Most utilities are used to create or alter files in some way. 

Many DCL commands invoke these utilities transparently to the user. 
Just as some DCL commands are passed to MCR, other DCL commands are 
passed to utilities. 

One important utility is PIP, the Peripheral Interchange Program, 
which is used to manipulate files. DCL functions such as APPEND, 
COPY, DELETE, PURGE, and DIRECTORY depend on PIP. As another example, 
the LINK command invokes the RSX-11M/M-PLUS Task Builder. Appendix B 
of this manual gives information on the relationships between DCL and 
the utilities and other system tasks. 

Each utility has its own command structure, but DCL commands allow you 
to use the most common functions of the most commonly used utilities 
without learning a new command set. For full access to the 
capabilities of the utilities, however, you may need to use them 
directly. To do this, you must run the utilities at your terminal. 
This is done with a RUN command in the form 

>RUN $utl 

where utl is the 3-letter name of the utility. If you wish to access 
one of the utilities Drovided bv Record Manaaemenh Services-! 1 
(RMS-11), use a command in the form 

>RUN $RMSutl 

where utl is the 3-letter name of the RMS-11 utility. 

Here is some information on each of the RSX-11M/M-PLUS and RMS-11 
utilities. RSX-11M/M-PLUS utilities are described in the 
RSX-11M/M-PLUS Utilities Manual . RMS-11 utilities are described in 
the RMS-11 documentation supplied with your system. Some system tasks 
that might be considered utilities, such as the Task Builder, are 
described in separate manuals. 
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Utilities described in the RSX-11M/M-PLUS Utilities Manual : 

• PIP - Peripheral Interchange Program - a file transfer program 
that provides means for copying, concatenating, spooling, 
renaming, listing, deleting, and unlocking files. 

• FLX - File Transfer Program - a file conversion program that 
provides means for transferring files from one operating 
system to another. Specifically, you can transfer files in 
DOS-11 and RT-11 format to RSX-11M/M-PLUS format (Files-11) , 
and vice versa. 

• DMP - File Dump Program - a file listing program that provides 
means for obtaining a printed copy of the contents of any 
file, including object files and task images, in any one of 
several useful formats. 

• EDI - Line Text Editor - an interactive editing program for 
creating and maintaining text files on a line-by-line basis. 

• SLP - Source Language Input Program - a utility that provides 
a means for maintaining and auditing source files. 

• LBR - Librarian Program - a library maintenance program that 
provides a means for creating, modifying, updating, listing, 
extracting, and maintaining macro and object library files. 

• VFY - File Structure Verification Program - a disk 
verification program that provides means for verifying the 
consistency and validity of the file structure on a Files-11 
volume. 

• PAT - Object Module Patch Program - a utility that provides 
means to patch, or update, a relocatable binary object module. 

• ZAP - ZAP Program - a utility that provides the means to 
examine and directly modify locations in a task image or data 
file. 

• BAD - Bad Block Locator Program - a utility that provides 
means for determining the number and location of bad blocks on 
a magnetic medium holding Files-11 volumes. 

• CMP - File Compare Program - a utility that provides the means 
for comparing two files and listing the differences between 
them. 

The RMS-11 utilities are provided as independent tasks to those who do 
not have full access to RMS-11 functionality, either because they are 
not programmers or are programming in a language other than MACRO-11. 

The RMS-11 utilities are: 

• RMSBCK, a backup utility that transfers any RMS-11 disk file 
to another disk or a magnetic tape in a special format that 
cannot be read or modified by a user program. 

• RMSCNV, a file conversion utility that moves records between 
two RMS-11 files of any organization or record format. 

• RMSDEF, a file definition utility that creates RMS-11 files, 
defining their attributes in an interactive sequence of 
questions and requests for data. 



1-1? 



INTRODUCTION 

• RMSDSP, a display utility that lists the RMS-11 file 
attributes and structural data or the names of RMS-11 backup 
files on magnetic tape. 

• RMSIFL, an indexed file load utility that builds an RMS-11 
indexed file using records from another RMS-11 file of any 
organization. 

• RMSRST, a file restoration utility that reads the backup files 
created by the RMSBCK utility and restores them with form, 
structure, content, and attributes identical to the original 
files. 

The RMSDEF utility is an interactive utility. That is, it performs 

its functions in response to a sequence of questions and requests for 

data. The remaining utilities are command utilities that operate by 
means of command strings input from the user's terminal. 

For descriptions of other useful and important system tasks, see the 
following manuals: 

• RSX-11M or M-PLUS System Generation and Installation Guide - a 
description of the process of tailoring a system to a 
particular installation. 

• RSX-11M/M-PLUS MCR Operations Manual - a description of MCR 
plus many details on system startup procedures and system 
operations, and a full description of the Indirect Command 
Processor . 

• RSX-11M/M-PLUS Batch and Queue Operations Manual - a 
description of the Queue Manager, which controls the orderly 
printing of files and other output, and the batch processing 
subsystem, a means of automatic use of the system. Batch 
processing is available on RSX-11M-PLUS systems only. 

• EDT Editor Manual - describes the use of EDT, the DEC Standard 
editor . The manual includes an introduction to EDT. 

• RSX-11M/M-PLUS Guide to Program Development - a detailed 
introduction to the program development facilities, both DCL 
and MCR, of RSX-11M/M-PLUS. 

• IAS/RSX-11 MACRO- 11 Programmer' s Reference Manual - an 
introduction to the MACRO-11 Assembly Language and Assembler. 

• RSX-11M/M-PLUS Task Builder Manual - a description of the task 
building, or linking, process in RSX-11M/M-PLUS. 



1.6.1 RSX-11M/M-PLUS DCL and VAX/VMS DCL 

DCL on RSX-11M V4.1 and RSX-11M-PLUS V2.1 and subsequent releases is 
designed to be compatible with DCL on VAX/VMS V3 . If the function 
being performed is identical, the same DCL command will have the same 
effect on an RSX-11M/M-PL0S system or a VAX/VMS system. As other 
operating systems adopt DCL, the same will be true for them. 

In most cases, the default forms of DCL commands will have the same 
effect on either kind of system. Furthermore, many qualifiers are the 
same and also have the same effect. 
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On the other hand, operating systems that implement DCL, including 
RSX-11M and RSX-11M-PLUS, will have system-specific extensions to DCL. 
For example, RSX-11M/M-PLUS systems have several features not 
available on VMS systems; DCL commands have been implemented to 
invoke these features. The command syntax for these features is 
different from any VMS command syntax to avoid confusion. 

In addition, many of the features discussed in this chapter are 
RSX-11M/M-PLUS extensions to the basic DCL language. Prompts, HELP, 
error messages, system displays, and command parsing (including 
abbreviating) are unique to RSX-11M/M-PLUS and may not be fully 
compatible with other DCL implementations. 



NOTE 

All the short forms and abbreviations i n 
DCL are intended for the convenience of 
interactive users at terminals. You 
should not use either these brief 
command forms, or other abbreviations 
shorter than four characters per command 
element, in indirect command files or 
any other permanent form. As new 
commands are added to DCL, these 
abbreviations may change, but the 
full-format commands are stable. 
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CHAPTER 2 
THE SET AND SHOW COMMANDS 



The SET commands dynamically alter system characteristics. The SHOW 
commands display system characteristics. 

These commands affect every part of the operating system. Some of 
them are needed by every user every day. Others might not be used 
once in a year. 

SET and SHOW both prompt 

Function? 

There are more than 20 functions that can be altered or established 
with the SET command, and more than 20 others, not all of them the 
same, that can be displayed with the SHOW command. Most of the SET 
functions include options, values, or negations. 

Customarily, the SET or SHOW command and the function are considered 
to form a single command. That is, rather than speaking of the 
TERMINAL function of the SHOW command, you would refer to the SHOW 
TERMINAL command. 

Some of the most commonly used variations on the SET and SHOW commands 
are described for your convenience in Sections 2.1 through 2.12. 

Full descriptions of all the SET and SHOW command functions appear 
later in this manual. Each chapter concludes with the SET and SHOW 
commands appropriate to that chapter. Thus, SET and SHOW TERMINAL are 
described at the end of Chapter 3, Terminal Operations, and SET and 
SHOW DEVICES are described at the end of Chapter 5, Handling Devices 
and Volumes. See the Table of Contents for references. 

The following are the most commonly used SET and SHOW commands, 
described here in brief form for your convenience. All of these 
commands are described in detail elsewhere in this manual. 



o i set awn Qunu ttmc 

SET [DAY] TIME [hh:mm[:ss]] dd-mmm-yy 

mm/dd/yy 

You can set both the time and the date with this privileged command. 
You can enter the date in either form, for example, 04-JUL-76, or 
7/4/76. In the latter case, mn stands for month number. No matter 
how you enter the date, it will be displayed in the first form. 

See Section 8.1.1. 
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SHOW [DAY] TIME 

This command displays the current setting of the day and time on your 
system. 

See Section 8.1.2. 



2.2 SHOW MEMORY 

SHOW MEMORY 

This command brings up the RMD display, which provides information on 
task activity, partitions, drivers, CPU usage, and so forth on your 
system. 

On video terminals, this display is dynamic. On hard-copy terminals, 
the command prints a snapshot of the current RMD display. 

The display provides a rough picture of the current state of the 
system. Alternate displays include the Active Task List or a single 
task header. 

Not all systems include this command for interactive use. Most 
systems, however, do run the display on a slaved video terminal 
somewhere near the computer . 

See Section 8.1.9 for more information on the memory display. See 
Section 7.12.3 for more information on the task list and task header 
displays . 



2.3 SET AND SHOW TERMINAL 

You can set and display many attributes of your terminal. The command 

SHOW TERMINAL 

without any qualifier, displays the current setting of all settable 
attributes of the terminal, as shown: 

TT5: [303,5] [303,5] 

CLI = DCL BOF = 132. HFILL = SPEED= (300 : 300) 

LINES = 66. TERM = LA34 OWNER = NONE BRO NOABAUD 

LOWER NOPRIV NOHOLD NOSLAVE NOESC NOCRT HFF NOREMOTE 

ECHO NOVFILL NOHHT NOFDX WRAP NORPA NOEBC TYPEAHEAD 

The display is explained in full in Section 3.8.2. Here, briefly, are 
the more significant fields: 

Terminal number, login UIC, default UFD 

CLI Current CLI setting 

BUF Buffer-length, that is, the width in columns 

SPEED Transmit and receive speed 

LINES Page length in lines 

TERM Terminal model 

OWNER Tells whether terminal has been allocated 

BRO Terminal can receive broadcast messages 

NOPRIV Terminal is not privileged 

The SET TERMINAL command permits you to set most of these attributes 
for your terminal. Privileged users can set the attributes of any 
terminal . 
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The format of the SET TERMINAL command is: 

SET TERMINAL/attribute [/attribute [s] ] 

Note that you can set more than one attribute at a time. A command 
such as the following: 

>SET TERMINAL/vTiOO/LOWERCASE/DCL 

is accepted by the system and executed. 

Here is a summary of the most important attributes you can set: 

/DCL /MCR /UPPERCASE /LOWERCASE 

/PAGE_LENGTH:n /WIDTH /SPEED: (transmit , receive) 

/[NO] BROADCAST / [NO] PRIVILEGE /SCOPE /HARD_COPY 

You can also set your terminal as a particular model: 



/ASR33 


/LA36 


/VT05 


/VT102 


/ASR35 


/LA38 


/VT50 


/VT105 


/KSR33 


/LA100 


/VT52 


/VT125 


/LA12 


/LA120 


/VT55 


/VT131 


/LA30P 


/LA180S 


/VT61 


/VT132 


/LA30S 


/RT02 


/VT100 




/LA34 


/RT02C 


/VT101 





See Section 3.8 for more information on the meaning of these 
attributes . 



2.4 SHOW DEVICES 

SHOW DEVICES 

This command displays the name and other information for all devices 
known to the system. 

SHOW DEVICES dd : 

This command displays the name and other information for all devices 

of a particular type known to the system, where dd is the 2-letter 

mnemonic for the device type or pseudo-device type. See Section 
5.10.3. 



2.5 SHOW QUEDE 

This command displays information about the queue file maintained by 
the Queue Manager. Two forms of this command are most useful. 

SHOW QUEUE 

This command displays information about all jobs in all queues. In 
addition to showing all queue assignments, the information display 
includes all Queue Manager QMG jobs and all files included in those 
jobs . 

On RSX-11M-PLUS systems, this display includes batch queues as well as 
print queues. 
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SHOW QUEUE/FULL 



This command displays full information about all jobs in all queues. 
In addition to the information displayed by SHOW QUEUE, SHOW 
QUEUE/FULL displays all the attributes of all the QMG jobs in the 
queue, such as /FORMS, /COPIES, and /PAGE_LENGTH. 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual for more 
information on the SHOW QUEUE commands. 



2.5.1 SHOW PROCESSOR 

SHOW processortype processorname[/qualif ier [s] ] 

where processortype is one of the following: 

BATCH 

CARD_READER 

DEVICE 

INPUT 

PRINTER 

PROCESSOR 

This command displays information about the card readers, batch 
processors, printers, and other devices under the control of the Queue 
Manager . 

CARD_READER and INPUT are synonyms. DEVICE refers to all nonbatch 
output processors and is a synonym for PRINTER. BATCH refers to all 
batch processors. (Batch processing is available only on 
RSX-11M-PLUS.) 

A simple SHOW PROCESSOR command displays all processors in the system. 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual for more 
information. 



2.6 SHOW ASSIGNMENTS 

SHOW ASSIGNMENTS [ :ttnn:] 

This command displays at your terminal all local and login 
logical-device assignments. See Section 5.10.1. 



2.7 SET AND SHOW DEFAULTS 

SET DEFAULT: [ddnn:] [g,m] 
where 

dd 

The 2-letter device mnemonic 
nn 

The 1- or 2-digit device number terminated by a colon 
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Lg/m] 

The UFD is two octal numbers separated by a comma and enclosed 
in brackets. 

This command alters your default settings for device and User File 
Directory (UFD) . 

The default device name and UFD are included automatically in every 
filespec included in a command unless overridden. See Section 4.5.1. 

SHOW DEFAULT 

This command displays your current default device and UFD. See 
Section 4.5.2. 



2.8 SHOW TASKS 

This command displays information about tasks in the system. Four 
forms of the command are most useful. 

SHOW TASKS/ ACTIVE 

This command displays information about the tasks active at your 
terminal . 

SHOW TASKS/ACTIVE/ALL 

This command displays information about all tasks active on the 
system. 

SHOW TASKS/INSTALLED 

This command displays full information about all tasks installed on 
the system. 

SHOW TASKS/ACTIVE FULL taskname 
or 

SHOW TASKS/INSTALLED FULL taskname 

These commands display full information on a single active or 
installed task. See Section 7.12.5. 



2.9 SHOW USERS 

SHOW USERS 

On RSX-11M, this command displays the terminal number and login UIC 
for each logged-in terminal. 

On RSX-11M-PLUS systems without Resource Accounting, this command 
displays the terminal number and login UIC for each logged-in 
terminal . 

On RSX-11M-PLUS systems with Resource Accounting, this command also 
displays for each logged-in terminal the default UFD, the date and 
time of logging in, the number of currently active tasks, and the 

user's name. 
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2.10 SET PROTECTION 

SET PROTECTION filespec[s] 

Pr otect i on? ( SYSTEM : RWED , OWNER : RWED , GROUP : RWED , WORLD : R) 

This command alters the access protection of a file or files. If you 
wish to protect more than one file, the filespecs must be separated by 
commas . 

There are four kinds of access to files and four classes of users who 
may access files. The previous example shows the the code for the 
default protection used on the system. 

The four classes of users who may access files are: 

SYSTEM Privileged users and the operating system itself 

OWNER Users logged in under the same User Identification Code 
(UIC) the file was created under 

GROUP Users logged in under the same group number as the UIC 
the file was created under 

WORLD All other users 

The four kinds of access to files are: 

R READ access. The file can be typed, printed, copied, run (if 
a task image) , and so on. 

W WRITE access. The file can be written to or altered. 

E EXTEND access. The file size can be changed. 

D DELETE access. The file can be deleted. 

These kinds of access are in hierarchical order. This means if you 
grant Delete access to a class of user, you are granting Read, Write 
and Extend access as well. 

The protection status shown at the beginning of this section is the 
default protection status accorded every file on the system. Use SET 
PROTECTION to change the protection status of files. 

You must enter the class of user and the type of access in the form 
shown. If you do not wish to change the access rights of a particular 
class of user, simply leave that class out. 

All users can set the protection of their own files. Privileged users 
can set the protection of any file. Note that you can set the 
protection of a file so no user, including yourself, can do anything 
with the file. If you do this, you will need a privileged user to 
reset the protection when you wish to use the file. 

You can display the protection of a file with the DIRECTORY command 
and /FULL qualifier. See Section 4.5.3. 



2.11 SET AND SHOW SYSTEM/DIRECTORY AND LIBRARY/DIRECTORY 

The Executive, privileged system tasks, and other system files are 

kept together in a single User File Directory (UFD) called the System 

UFD. In most cases, this will be UFD [3,54] on the system disk. An 
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CHAPTER 3 
TERMINAL OPERATIONS 



The terminal is your main channel of communication with the computer 
system. The information in this chapter tells you how to use a 
terminal to communicate and interface with the RSX-11M and 
RSX-11M-PLUS Operating Systems. For a quick review of basic 
operations at a terminal, refer to the Introduction to RSX-11M and 
RSX-11M-PLUS . 

The discussions in this chapter are organized around three DIGITAL 
terminals: the LA36 hard-copy terminal (DECwriter II) and the VT52 
and VT100 video display terminals (DECscopes) . These terminals do not 
always behave in exactly the same way; variations are noted in the 
descriptions of terminal functions in this chapter. If you are using 
another type of terminal, check with your system manager for special 
instructions. In any case, you should read the manual shipped with 
your terminal to get full use of your terminal on the system. 

A typical terminal keyboard is shown in Figure 3-1. A keyboard is a 
set of alphanumeric keys, similar to the set on a typewriter. The 
keypad shown in the illustration is a set of special keys. Where 
pertinent, the functions of these keys will be explained in this 
chapter. All terminals will have some form of a keyboard; some 
terminals will not have the keypad. 
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Figure 3-1 Terminal Keyboard and Keypad 



Each terminal on an RSX-11M/M-PLUS system has a number. Your terminal 
number is displayed when you log in. Your terminal number is also 
used by the system to identify tasks run from your terminal. (See 
Section 7.1.1 for more information on task naming.) 
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You can set many characteristics for your terminal using the SET 
TERMINAL command (Section 3.8.1). The characteristics of your 
terminal can be displayed with the SHOW TERMINAL command (Section 
3.8.2). In addition, the SHOW USERS command (Section 8.1.8) displays 
the terminal number, default UFD, and login UIC for each logged-in 
user . 

On RSX-1.1M-PLUS systems with Resource Accounting active, SHOW USERS 
also displays the user's name and the number of currently active 

■:■: ta S i: KS .' :! '::.' 

Frequently, users work from more than one terminal. You can always 

use the pseudo-device name TI: to refer to the terminal you are 

currently using. You do not need a specific number. In most cases, 

when a system task requires you to name an output file, you can 
specify TI : and the output will be printed on your terminal. 

A terminal is said to be attached if all its input and output is 
directed to or from a task. If you invoke a task, it may attach your 
terminal so that no other task can use the terminal for I/O. When you 
exit (for example by typing CTRL/Z) , the task detaches the terminal. 
When you are using an editor, the editor has your terminal attached. 

Terminals may also be dedicated exclusively to a task. Such terminals 
are called slaved terminals. Tasks can slave terminals, or terminals 
can be set slaved through the SET TERMINAL command. Terminals can 
also be set slaved on logging in. Slaved terminals can communicate 
only with tasks soliciting input from the terminal. 



3.1 LOGGING IN AND LOGGING ODT 
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software before you can use it. You can assume it is connected to the 
hardware. Connecting to the software is called logging in; 
disconnecting from the software is called logging out. 

Logging in informs the system that you will be using a terminal. 
Logging out informs the system that you are through using a terminal. 

Most terminals have an accessible on-off switch. This switch supplies 

power to the terminal, but it has no bearing on whether the terminal 

is logged in. If you turn the power switch off, a logged-in terminal 
remains logged in. 

You can test whether a terminal is turned on and available by pressing 
RETURN or CTRL/C. The RETURN key causes the right-angle-bracket 
prompt (>) to appear. The CTRL/C causes the explicit prompt (DCL> or 
MCR>) to appear. 

The SHOW DEFAULTS command tells you whether the terminal is logged in 
or not. If it is not logged in, the command produces an error 
message. If it is logged in, the command displays the current default 
device and UFD. 

If the terminal is already logged in, you should type CTRL/C to 
determine whether the terminal is set to DCL or MCR. If the terminal 
is set to MCR, type in ACT as shown: 

MCR>ACT 

If the terminal is set to DCL, type in SHOW TASKS/ACTIVE as shown: 

u L. u .•••3 rl u w imSKs/hv-Iivc. 
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LOGIN 



This command will inform you whether the terminal is in active use or 
not. It is not good practice to take over a terminal while another 
user has tasks (other than CLIs) active at the terminal, as you may 
interfere with the other user's work. Check also with SHOW DEVICES to 
see if the other user has devices allocated or volumes mounted. If 
the other user has no significant activity under way, use your own 
judgment as to whether you should log the other user out, using either 

DCLH.0G0UT 
or 

MCR>BYE 

and, after the terminal is logged out, log yourself in. 

If you are not sure how to log in, type HELP for help in logging in. 

If the terminal is not logged in, you may log in. Unlogged-in 
terminals are not set to either DCL or MCR. You can log in to an 
RSX-11M/M-PLUS multiuser protection system using either HELLO or LOGIN 
together with your User Identification Code and your password. The 
system's Account File Maintenance Program (ACNT) identifies each user 
as either a DCL or MCR user and sets the terminal accordingly. See 
the description of LOGIN (Section 3.1.1} for further information on 
the effects of logging in. 

Remember, you can change the CLI of your terminal from DCL to MCR or 
vice versa with the following commands: 

MCR>SET /DCL=TIJ 

or 

DCL>SET TERMINAL/MCR 

All RSX-11M/M-PLUS systems with DCL are multiuser protection systems. 
This means that the system includes features, such as LOGIN and LOGOUT 
and ALLOCATE (Section 5.4), that enable many users to use the system 
without interfering with each other's work. 



3.1.1 LOGIN 

LOGIN grants access from a terminal to a multiuser protection system. 
LOGIN also establishes certain characteristics of your terminal 



Format 



LOG[IN] 

user id 

Password: password 

LOGIN userid 
PASSWORD: password 

LOGIN uic/password 
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Parameters 

userid 



Specifies the User Identification Code (UIC) of the user logging 
in. Five forms of UIC are accepted by this command: 

[g,m] 

g f m 
[g/m] 

g/m 

nsrns 

If you log in with a comma in the UIC, or if you log in by name, 
a file called LBO: [ 1,2] LOGIN.TXT is printed on your terminal. 
This file is prepared by your system manager and usually contains 
information about the system and other announcements. If your 
system displays such messages, using a slash (/) instead of a 
comma (,) between the group and member numbers suppresses these 
messages . 

Your system may also have a file called LBO: [1 ,2] SYSLOGIN.CMD. 
This file can contain a number of system-level commands that your 
system manager wishes to have executed each time a user logs in. 

Finally, you, as an individual user, can prepare a file called 
LOGIN.CMD to be kept in your UFD (User File Directory) to be 
executed each time you log in. This LOGIN.CMD file usually 
includes commands for setting up the terminal and the account for 
regular use. 

The LOGIN command interacts with the Account File Maintenance 
Program (ACNT) to establish a number of characteristics of the 
terminal session you are beginning. These include your default 
device (where your files are located) , an indication of whether 
your account is privileged or not, and whether your terminal is 
to remain slaved after login. See your system manager for 
information on how this will affect you. 



password 



Your password is limited to six Radix-50 characters. If you 
enter your password in response to the Password: prompt, your 
password is not echoed on the screen. If you type in your 
password on the same line as your UIC, the password is echoed. 
Your password is established by your system manager as part of 
setting up your account. 



Examples 



>LOGIN 

Account or name; KAFKA 

Password t 

RSX-11M-PLUS V02 BL15 Multiuser C3.543 System 
20-Nov-82 09J16 Losisfed on Terminal TT54: 

Good Horning 

November 20» 1982 System (isnsSer 
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** System will be down tonight from 21500 to 24500 ** 

** DISK-TO-DISK BACKUPS ** 
Please purge your files! MM!!!!!!!!!!!!!!!!!!!!!!!!! 
November i, 1982 Operator 
Magtape drive MM15 is down until further notice. 



In this example, full login text is automatically printed on the 
terminal because the user logged in with a name (KAFKA) . The 
full login text is also printed if you log in with a UIC entered 
with a comma [g,m] . See next example. 

The prompt signifies the completion of logging in. 

>L0GIN 303/5 
Password 5 

RSX-11M-PLUS V02 BL15 Multiuser C3,54D System 
20-N0V--82 09118 Loaded on Terminal TT56! 

Good Mornins! 

November 20? 1982 System Manager 

#* System will be down tonight from 21500 to 24100 ** 

** DISK-TO-DISK BACKUPS ** 
Please purge your filesMMiMMMMMMMiiMiiiiiii 



This example shows the first login of the day for this user. The 
UIC was entered with a slash (303/5) . The printing of the system 
LOGIN.TXT file in full was therefore suppressed. Only the first 
message (defined as being a priority message by the system 
manager) was printed. The priority message is printed only on 
the first login of the day. This ensures that users who 
habitually log in with the slash do not miss anything. See next 
example. 



>L0GIN 303/5 
P a >:> s w o r d ! 

RSX-11M-FLUS ^02 BL15 Multiuser C3»541 System 
20-N0V-82 10536 Logged on Terminal TT545 

Good Morning 



This example shows a subsequent login on the same day by the same 
user. Note that no system messages are displayed. 
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> LOG IN 

Account or name J 301/370 

Pesswordt 

RSX-11M-PLUS V02 BL15 Multiuser L1,5A1 System 
20-N0V-82 19536 Loosed or. Terminal TT45! 

Good Evening 

X5L0GIN.CMD 

>SET TERMINAL/LOWER 

>ASSIGN RS; DBi; 

>e<EGT> 

This user has prepared a L0GIN.CMD file in his UFD to set up the 
terminal and make a logical assignment. The LOGIN.CMD file is 
run automatically each time the user logs in. The commands shown 
are issued by the indirect command file; the @<E0F> marks the 
end of the command file. 

Notes 

LOGIN and HELLO are identical. LOGIN does not work on systems 
without DCL, however. 

LOGOUT counteracts LOGIN. 

i a ih«a *i/-Ni-» ov.r-s "!/-\i^rrt*^<fl in 3n/3 4-Vio ewef om A 1 cnl ai; Viae VtciCi rt r-.tr ', n4-£iH r\n 

your terminal, the system searches the User File Directory you 
logged in to for a file named LOGIN.CMD. This indirect command 
file can contain any commands you wish. This feature is commonly 
used to set up your terminal for regular use, as shown in the 
example. See the RSX-11M/M-PLUS MCR Operations Manual for more 
information on indirect command files. 

It is wise to log in occasionally without the slash to be sure 
you have not missed any important messages. 

Error Messages 

MCR — Not logged in 
DCL — Not logged in 

Explanation: The terminal is not logged in. 

User Action: Log in using either LOGIN or HELLO. 

LOG — Account file open failure 

Explanation: The system could not access the account file for 
some reason. 

User Action: Try again. Wait and try again. If the message 
recurs, see your system manager. 
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LOG — Invalid account 

Explanation: The name or UIC, or the password, given in the 
command is not recorded in the account file. 

User Action: Retype the command using correct data. 

LOG — Logins are disabled 

Explanation: The system is being shut down, or a privileged user 
has issued SET NOLOGINS for some other reason. 

User Action: You cannot log in. Try again later. Often, when 
logins are enabled again, the operator sends a message to all 
terminals. 

LOG — Other user logged on 

Explanation: Another user is logged in. Only one user at a time 
can log in on a terminal. 

User Action: Issue SHOW USERS to find out who is logged in. 
Issue SHOW TASKS ACTIVE to find out what tasks are active on the 
terminal. At your discretion, issue LOGOUT and then log yourself 
in. 

LOG — Terminal allocated to other user 

Explanation: The terminal has been allocated (made private) by 
another user. You cannot log in on an allocated terminal. 

User Action: Go to another terminal. Issue SHOW DEVICES TT: 
and find out which terminal has your terminal allocated. 



3.1.2 LOGOUT 

LOGOUT logs the user off a multiuser protection system. 

LOGOUT also aborts any active nonprivileged tasks running from the 
terminal as well as dismounting any private volumes and deallocating 
any private devices allocated from the terminal. 

Format 

LO[GOUT] [/HOLD] 
No prompts. 
Command Qualifier 

/[NO] HOLD 

The /HOLD qualifier is for use on remote or DECnet host 
terminals. If you include the qualifier, the terminal is logged 
out but the line is not hung up. This means you can log back in 
without reconnecting the line. The default is /NOHOLD, meaning 
that when you log out, the line is also hung up. 
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Examples 



>L.a60UT .."'.;;, " ' i! ;" 1 "', ;•;' 

Have 3 good afternoon 

04--NOv-82 12113 TT13! Loosed off ZENITH 

In this example, the user logged off an RSX-11M system. The 
terminal is free for logging in. ZENITH is a DECnet node name. 
This information does not appear on systems without DECnet 
support . 

>LOG0UT ' ; ■ - : • ■ ■ ' 

Connect time! 44 minutes 1-, "'■■■. '"",', 

CPU TIME USED! 256 seronds lj:v-.i " i[ ""I '"'~' : ■ h 'Z "■' 

Task total! 90 ' 

Have a <i n o d 3 f I mi i i o o n 

08- SEP- 82 1,-.:r>f; TT10! Lagged of*' PRINCE 

In this example, the user logged off an RSX-11M-PLUS system. The 
information on system use is not printed on systems without 
Resource Accounting running. The terminal is free For Logging 
in. (PRINCE is a DECnet node name.) 



>L0G0UT 

DM0 -■- TT10! Dismounted from DXO! 

Connect time! 32 minutes 

CPU tin:s used* 12 seconds 

Task total! 21 

Have s i3o od morning 

08-SEP-82 11117 TT10! Logged off ROMPER 

In this example, the user had a volume mounted on device DXO:. 
The LOGOUT command dismounted the volume, as the message states. 
If the device was allocated, the LOGOUT command will deallocate 
it, but will not issue a message. 



>L0G0UT 

13529J36 Task "TT10 " Terminated 

Aborted vi3 directive or CLI 

Have 3 good afternoon 

19-N0v-82 13113 TT10! Logged off 

In this example, the user had a task running from the terminal at 
the time the LOGOUT command was issued. The command caused the 
task to be aborted. 

Notes 

LOGIN counteracts LOGOUT. You need type only LO to log out. 

The LOGOUT command works only on terminals set to DCL. If the 
terminal is set to MCR, use the BYE command. Type a CTRL/C to 
find out which CLI the terminal is set to. 
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3.1.3 ACNT, the Account File Maintenance Program 

Account files on RSX-11M and RSX-11M-PLUS are created and maintained 
by ACNT, the Account File Maintenance Program. Whenever a user tries 
to log in, the system checks the user identification and the password 
against the account file to determine whether the user should be 
allowed access to the system, and with what privileges. 

The account file describes all the UICs and associated passwords that 

have been authorized for a multiuser protection system. ACNT also 

associates a CLI (usually DCL or MCR) and a default device with each 
user . 

Privileged users have full access to the functions of ACNT, as 
described in the RSX-11M/M-PLUS System Management Guide . 
Nonpr ivileged users can change their password with ACNT if Resource 
Accounting is active on the system (see the RSX-11M/M-PLUS MCR 
Operations Manual for more information) but should see the system 
manager to change other aspects of their account. 

You should not confuse ACNT with Resource Accounting, which is 
described in Section 3.1.4. 



3.1.. 4 Resource Accounting an J»SX-11M-?L0S 

IISX-1IM-PLUS systems include Resource Accounting as a 

system-generation option thai provides < Eii.e of information on system 

use. Data i: gathered both foi the individual user . j .n1 for the 

system. !ii ■ „.. '";■'■ , ■ ■ .L:.,.. ■■■:■■-. .'- "; v .; ■■■■■■■■■ .:':..: .. : ':"':. : .'■■■-.. 7!;'..; "-■/",. — ",, ! 

When you Log in, after LOGIN chucks the validity of your UIC and 
password, Resource Accounting assigns a number to 1 be terminal 
session. This number can optionally include a 1- to 3-character 
personal identifier. Thy-;, each time you Log in, the terminal session 
is identified by the number and the personal identifier. Tt yon are 
logged in r,n two terminals -s.t vr.ee, each session has a different 
number but the same personal identifier. 

When you log out, Resource Accounting displays the time you were 
logged in, the CPU time us.ed> and the numbei of tasks us^d. 

Users Can also display current Resource Accounting data : with ; the" 

command SHOW ACCOUNTING/INFORMATION, described in the next section. 

The data gathered by Resource Accounting makes possible 'billing.''- of 

oq ' i J u : i users £ o ** ^^ * t ' »t c *"> m -*- «~ n tr ^~* "*-■ ^*~* » *~ * ns^-i^s^v-vt-ss-*^ * r 
overall' system usage. ■ 

For further information on Resource Accounting, see the RSX-11M/M- PLUS 
System Management Guide . " 



3.1.4.1 SHOW ACCOUNT I NG/ INFORMATION 

SHOW ACCOUNTING/INFORMATION displays current information on terminal 
session. Privileged users can display this information for any 
terminal session. Nonprivileged users can display information about 
their own terminal sessions. 
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The command displays the Use* Account Block from Resource Accounting. 

Format ■•■.. ,--■.,.' .-;.*.■""' . . " ' ' • ■ . . .'.-•■'■ 

•' '• show ' " ." V ■■ ; ■'••.' ■ ■ 

Function? ACCOUNTING ^ ?:,v : '-.Tl:. t< ' < v 7\- ': « : ".,.■.."> " .■,,..' ':' ■ -''U..; "^ : ' ^,:, [ ;"- i - .. 

"' ■• ■:;...."]': At tr ibute? I NKOKMATION f ttnn : ] '" "^ ;" „, ; ■" ' :;.. ; ;; L ; ,'■"" i ' , ■ ;"" : ; " ■■; 

SHOW ACCOUNTING/INFORMATION [ttnn:] 

Parameter ' '■-.,'/ -,."/' " " . , : ■-.< ,' .'.,*'.' • '' ' : ' .' , *,'""•' ,' 

ttnn : ,„',„"''■"' . n- , -=«• -"'J, "'* r ■ B,B t:: ' ■ 'B, ' ;' *»,, ''"'.',',' : " " *■,;., '""' : " "B... ,,,', "'-" I:: ' ?■ ■ 

Specifies the terminal for whion accounting inC9r.n1at.1Cfi i =s to be 
shown. Privileged usees can display information for any 
terminal. Nonpr ivileged users can only display information about 
the terminal they are logged in on. 

Privileged users can specify CO: in this field to display data 
fo; system tasks running on pseudo Jevice CO: on their terminal. 

Privileged users can specify SYS for this field to display 
current system totals on their terminal. 

The default for this field is TI:. 

Example 

>SHOU ACCOUNTING/INFORMATION 



USER - KENNEDY T 

SESSION ID = WRT751 TI! = VT3! ACCOUNT = 0. 

LOGON UIC = C303r5: LOGGED ON = 26-JUN-82 09:51:29 

LOGGED OFF = 00-000-00 OOtOOJOO BILLING STOPPED = 00-000-00 00:00500 

CPU = 15. TASKS ACTIVE = 2. TASKS RUN = 5. 

DIRECTIVES = 77. QI0S =25. 

>SH0W TIME 

09*. S2I21 26-JUN-82 

;: ::=:^* ; j- ^; : ';;- : -:-!:!:;:! : ^!!. : v : >:- \^ ;>;;r:- : ; ; ;:-- : ■■■'■ .'.,:■■■■■- :^! ! .:■.: : '.■ :: ■■ : - ! .■■::.■::v : '.■: : : : ■' !i, ■ - :'";.-; : ; : :::- : -=!.-'"! : ! .!;^ "- ' : -'^-' : '!'!:;! : " :M --=:'- !: "ii : .-": : ■ V \ : : : !"-V-"V ! !: : .'" ■■BT'"B-7..-'.: :'■■.'■ ■■ [ ' ■■ ■■■■■■■■■::-:■ ' >V : ;:"^-^':^ : .l':iki'X-'"! :: ' : '''^ ■"■ : !' |: " : :: - -".'.' .■ ; ■ : T/: : '. : ' : :''"'-' :: ' ■ '■■'^■■^■■^-.'^B. 

.: SHOW ACCOUNTING/INFORMATION :" >"v; >■: "■<■, '"V ..v"' 1 ^ '-."\ ._■>•:., * ■; ..■"■■■».•'''"'.' ' "■ 

USER - KENNEDY . T '■>■■■ "'"i.;, --'"' "...■■ '-■. . '-.- 

SESSION ID - WKI731 1'lt =• VT3J ACCOUNT = 0. 

LOGON UK, = [303,53 LOGGED ON - 26-JUN-82 09151:29 

LOGGED OFF = 00-000-00 OOJQOJOO BILLING STOPPED = 00-000 00 00:00J00 

CPU,-: = 38 , ;;- "; ';.;.. " TASKS ACT I VE = 2 . • " : TASKS RUN - = 9 . " '=,.:. : > - 

directives = 146 . H',;/"" : i v qios ---• 58* *":\ ■..'; ; ' ;:,:',; ": ,,.;; : "B ;. ,: * ' 

In this example, the display identifies the user, including the 
session ID and the terminal. The ACCOUNT number is not used. In 
addition, the display shows the login UIC and the time of longing 
in. Since tnc command was issued while the terminal session 
continue-], the time of logging off and the end of billing is not 
shown. (The limes of logging off and the end of billing m/sy not 
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be the same if the us or has joes in the clock queue.) Finally," 
the display shows CPU time in ticks, the number of tasks active, 
the number of tasks run since logging in, and the number of 
Executive directives and QJOs issued. 

Notice the difference in the two displays. The first display 
shows five tasks run. The user then issued a SHOW TIME and a 
second SHOW/ ACCOUNTING INFORMATION. The second display shows 
nine tasks run. The additional four tasks were the DCL 
interpreter, the first SHOW, the DCL interpreter again, and the 
second SHOW. The latter two are the two active tasks. 



Notes 



See y° ur: system manager for further information on how Resource 
Accounting is used in your installation. 

The length of a tick is defined at system generation. In most 
cases, 'the length of i tick is determined by year lot.il Line 
frequency. In most North American locations, the line frequency 
is b i,! Hertz., and 3 tic:-: is equal to l/60th of a second. In 
overseas locations, the most common line frequency is 50 Hertz, 
yielding a tick length of l/50th of a second. Some installations 
may include a programmable clock. The tick length is variable on 
systems with a programmable clock. Seo your system manager for 
more information. .'■"-. ^ : ;::>""-'■" - : - ■'■:■ :"' : - - : .:- ■■'..• ■■'■ - '■ :: ~:. :-'€.. ■ a;: 7<~r .- :■■■ .. ;;■;; "::/,=: 



3.2 THE KEYBOARD 

Most of the keys on the main keyboard are self-explanatory. They 
function much the same as they do on a typewriter. Only the most 
important differences from typewriter operation are noted here. See 
Table 3-1 for the names of keyboard characters as used in system 
documentation . 

You should remember that a computer terminal is not a typewriter. A 
computer terminal has two functions, transmitting input to the 
computer and receiving output from the computer. Usually, when you 
press a key, the letter appears immediately on your terminal. When 
you pressed the key, you sent a character to some system task or 
program. One of the actions the system normally takes upon receiving 
a character is to send it back to your terminal as an echo. This 
usually happens so fast that it appears that you are typing on your 
terminal, but you are not. You are sending input to the system and it 
is sending output to your terminal. A terminal is an input/output 
device. 

Occasionally, when heavy demands are being made on the system, there 
may be a noticeable lag between the input and the echo. 

You should also remember that keys may behave differently when sending 
output to some task other than DCL. For instance, all the keypad 
keys, plus the ENTER, BACK SPACE and LINE FEED keys, have special 
meanings when you are running EDT, the DEC Editor. Special 
applications software at your installation may also use special 
meanings for certain keys. This chapter covers key use for DCL, also 
called monitor level. 
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3.2.1 RETURN and Command Line Length 

The RETURN key has two functions. it is used in the conventional way 
to supply a line feed and a carriage return, but the key is also used 
to signal the system that you have finished typing a command. 
Commands can be quite varied in length; the RETURN key defines the 
length of the command. The symbol <RET> is used in this manual to 
signify that you press the RETURN key. Thus, 

>PRINT IZZY.TXT §3 

is a complete command, and so is 

>print/copies:2/form:i/delete izzy.txt m 

If you must enter a command that is longer than a single line on your 
terminal, you can override the effect of the RETURN key by ending the 
line with a hyphen before pressing the RETURN key. This works as 
follows : 

>PRINT/C0PIES:2/F0RM:i/DELETE IZZY.TXT, OZY.txt, MADISON. AVE,- (RET) 
->/FUZZY.TXTJ12, GUNGA,DIN?2 (RET) 

The hyphen tells the system to postpone execution of the command until 
it receives a carriage return not preceded by a hyphen. In the 
example given, the user had more files to be printed together than 
could be specified on a single line. The hyphen called for the 
special continuation prompt (->) rather than execution of the command. 
The carriage return without the preceding hyphen then called for 
execution of the full command. For more information on command line 
continuation, see Section 1.2.13. 



NOTE 

In most examples and command formats in 

this manual, the carriage return at the 

end of a line containing a command or 

command element is assumed and is not 
shown. 



3.2.2 Line Terminators 

You can terminate a command line with either the RETURN key, or with 
the key variously labeled ESC, SEL, or ALTMODE. CTRL/Z and CTRL/C are 
also line terminators. Each of these terminators has different 
effects. The RETURN and ESC keys are discussed here. The control 
characters are discussed in Section 3.4. 

The ENTER key on the keypad is identical with RETURN at DCL monitor 
level . 

When you terminate a command line with the RETURN key, as soon as the 
command is processed, the implicit DCL prompt reappears, ready for 
another command. For example: 

>SH0U TIME (RET) 
09:59:21 13-DEC-82 

You need not wait for the return of the prompt to enter another 
command . 
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When you terminate a command line with the ESCAPE key, DCL does not 
prompt after the command has been processed. For example: 

>SHOU TIME m 

I0:05t38 13-BEC-82 

The cursor or print head appears at the beginning of the line with the 
time on it. 

The LINE FEED key provides a line feed without a carriage return. It 
cannot be used as part of the command line and is not a terminator. 



3.2.3 DELETE Versus BACK SPACE 

You should avoid the BACK SPACE key. This key is included on 
terminals for compatibility with other systems but is not used in DCL. 
The BACK SPACE key does not produce an echo, but it can have confusing 
results when used in a file or when entering a command. When you make 
a typing mistake, use the DELETE key to correct it, not BACK SPACE. 
(The BACK SPACE key may be used for special functions within tasks 
such as EDT.) 

The DELETE key (labeled RUBOUT on some terminals) works in a slightly 
different fashion on video and hard-copy terminals. 

On hard-copy terminals the DELETE key removes the last character typed 
and then verifies the removal by repeating the removed character on 
your terminal preceded by a backslash. This action is repeated each 
time you press the DELETE key. For instance, the sequence 

>RUN FEEBER !B (IDLE 
appears on a hard-copy terminal as 

>RUN FEEBER\RE\LE 
But the operating system receives the command: 

>RUN FEEBLE 

You can verify this by typing a CTRL/R after the corrected line to 
retype it properly, without the intervening deleted characters, thus: 

>RUN FEEBER\RE\LE SO 
>RLIN FEEBLE 

On a video terminal, the DELETE key actually erases the last character 
typed on your screen and you can replace it directly. The deleted 
characters are not repeated. For instance, 

>RUN FEEBER (BeC & LE 

The sequence appears on a video screen in succession as follows: 

>RUN FEEBER 
>RUN FEEBE 
>RUN FEEB 
>RUN FEEBL 
>RUN FEEBLE 

If you are using an editor that permits you to move the cursor around 
on the screen, the DELETE key deletes the first character immediately 
to the left of the cursor location. 
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3.2.4 CAPS LOCK and SHIFT 

On most video terminals, the CAPS LOCK key causes all letters to be 
typed in uppercase. This key affects only letters, not numbers or 
symbols. You can engage CAPS LOCK and type ' RSX-11M-PLUS ' without 
disengaging it, even though the numbers and the hyphens are lowercase. 

The SHIFT keys set your terminal to uppercase for the keys not 
affected by CAPS LOCK, as well as for individual alphabetic 
characters . 

On most hard-copy terminals, CAPS LOCK sets all keys to uppercase. 

Different terminal models vary widely in their treatment of CAPS LOCK 
or the equivalent key. You should experiment on your terminal. 



3.2.5 REPEAT 

The REPEAT key on the VT52 and LA36 repeats the action of any other 
key. You can use it to insert a series of blanks, characters, 
carriage returns, or whatever. Use it by holding down REPEAT and the 
key whose action you wish to repeat. It is particularly handy with 
the DELETE key. Normally, a DELETE-REPEAT combination deletes back to 
the left margin of your terminal and no further. 

Most keys on the VT100 repeat automatically if you keep the key 
depressed. There is no REPEAT key on the VT100. 



3.2.6 SCROLL and NO SCROLL 

The SCROLL key on VT52s is used together with the SET TERMINAL/ 
HOLD_SCREEN command. This command limits the terminal to one 
screenful of information at a time, allowing you to read output that 
requires more than one screen's worth of space. If HOLD_SCREEN is 
set, the SCROLL key moves the display up one line at a time. SHIFT 
and SCROLL together bring up a new screenful of information. (A 
CTRL/C or SET TERMINAL/NOHOLD_SCREEN returns the terminal to normal.) 

The NO SCROLL key on the VT100 simply causes the terminal to stop 
scrolling. When you are ready for the terminal to scroll, press the 
NO SCROLL key again. 

See also the discussion of the CTRL/S and CTRL/Q keys in Section 
3.4.2. 

See the documentation provided with your terminal for information on 
controlling scrolling on other terminal models. 



3.2.7 Other Keys 

The COPY key is used only on terminals with a copier. 

Other keys are listed in Table 3-1, along with common names for them. 
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Table 3-1 
Keyboard and Keypad Characters 



Character Name Comments 



Circumflex On some keyboards, this 

character appears as an 
up-arrow. It should not 
be confused with the 
cursor-control keys on the 
keypad, which also have 
arrows . 

At monitor level, the CTRL 
key sometimes echoes as a 
circumflex when struck in 
combination with a letter. 

If you wish to include 
CTRL/a characters in a 
batch job. the letter 
preceded by the circumflex 
will be treated as a 
CTRL/a. 

In BASIC programs, the 

circumflex is the 

mathematical operator for 
exponents . 

Right-angle bracket General term. 

Greater-than ASCII name of character. 

Used in mathematical and 
logical expressions. 

Implicit monitor At monitor level, 
Prompt signifies that system is 

ready to accept commands . 
The explicit monitor 
prompts are MCR> and DCL> . 

Left-angle bracket General term. 

Less-than ASCII name of character. 

Used in mathematical and 
logical expressions. 

Period In text. 

Decimal point In numbers. 

Dot In filespecs, terminator 

between file name and file 
type. 

The period keys on the 
keyboard and keypad are 
identical at monitor 
level . 

(continued on next page) 
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Table 3-1 (Cont.) 
Keyboard and Keypad Characters 



Character 



Name 



Comments 



{ 3 




At sign 
Commercial at 

Number sign 
Ampersand 
Percent sign 
Wildcard 

Asterisk 

Wildcard 



Underscore 



Hyphen 



Minus 



Plus 



Colon 



Equal sign 

Braces 
Parentheses 



Indirect 
operator , 



command 



file 



ASCII name. Not in the 
international character 
set . 

Not pound sign. 



General term. 

Stands for "match one 
character in this 
position" in file names 
and file types. 

General term. 

Stands for "match any or 
no characters in this 
position" in file names 
and file types, or for any 
group, member, or version 
number . 



Used to tie command 
together in DCL. 



words 



DCL continuation 

character . Used for 
command lines too long for 
terminal line. Overrides 
RETURN. Command not 
entered until monitor 
receives RETURN without 
preceding hyphen. 

Mathematical operator for 
subtraction. 

Mathematical operator for 
addition. 

Marks beginning of 
argument in DCL command. 

Mathematical and logical 
operator. Also used 
extensively in MCR syntax. 



(continued on next page) 
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Table 3-1 (Cont.) 
Keyboard and Keypad Characters 



Character 



Name 



Comments 



[] 
/ 



Square brackets 



Slash 



Backslash 



Delimiters for UIC and UFD 
numbers . 

Marks beginning of 
qualifier in DCL commands. 

Must be preceded by space 
in MCR commands. 

On hard-copy terminals, 
delimiter for deleted 
characters . 



3.3 THE KEYPAD 

Some terminals have a second set of keys to the right of the main 
keyboard, arranged much like a bookkeeper's keypad. These keys make 
up the keypad . 

The keypad keys are available for special functions. Some functions 
of the operating system use these keys. They may be used in many 
other ways, depending on the particular installation. The following 
description covers only the uses of the keypad by functions at the 
monitor level. 

The keypad numbers work in the same way as the numbers on the regular 
keyboard except that the symbolic characters are not available from 
the keypad . 

The period key works in the same way as the period on the regular 
keyboard. It is used for including the decimal point in numbers. 

The ENTER key works the same as the RETURN key on the main keyboard. 

The three blank keys on the VT52 are reserved for special functions. 
They are not used at monitor level. The same is true of the PF keys 
on the VT100. 

The four "arrows" are used for cursor control by EDT, the DEC Standard 
Editor, but are otherwise available for special functions. 

The blank, PF, and cursor-control keys can have seemingly paradoxical 
effects if struck carelessly or accidentally. These keys each send an 

RSrSPR nhav;a»->4-ov a r* ^ r» r-i *>. r\-r mr^-m ^K -^ »- -, s~ 4- rt ~ .-. 4 i-u~ j-: i 

The ESCAPE is a nonprinting character, but the associated letter can 
be echoed on the terminal and may make the operating system behave as 
if you had typed that letter. 

Here is how these special keys are set up on the VT52: 



up-cursor 
down-cursor 
right-cursor 
left-cursor 
blue blank 
red blank 
gray blank 



types A 
types B 
types C 
types D 
types P 
types Q 
types R 
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If, for instance, you were to type a down-cursor while in DCL mode, 
you might find yourself being prompted To? because the down-cursor 
key sent a B to DCL, which interpreted it as the short form of the 
BROADCAST command. (To exit from any command or prompt, type a 
CTRL/Z.) 

Here is how these special keys are set up on the VT100: 



up-cursor 

down-cursor 

right-cursor 

left-cursor 

PF1 

PF2 

PF3 

PF4 



types [A 
types [B 
types [C 
types [D 
types OP 
types OQ 
types OR 
types OS 



3.4 THE CTRL KEY AND CONTROL CHARACTERS 

The key marked CTRL is called the control key. It is used much like 
the shift key on a regular typewriter. If you hold down the CTRL key 
and then press another key, you are sending a command to the operating 
system. The CTRL key alone has no effect. 

The combination is designated by CTRL/a , where a is the chosen letter 
key. 



your terminal, the CTRL key is 
Type a CTRL/U and you see a ~U on 



letters combined with the CTRr. key. 
0, Q, R, S, U, X, and Z. These are 



When the combination is echoed on 
represented by the circumflex (*) 
your terminal. 

The o^eratin system recognizes 11 

The letters are C, I, K, L, 

discussed below in approximate order of importance. 

With the exception of CTRL/Z, the control characters are commands 
directed to the operating system and not to any task you may be 
running from your terminal. This means that they usually work without 
interfering with such tasks. For instance, CTRL/0 is used to skip 
over terminal output. It skips over any output, whether sent by DCL, 
the Task Builder, an editor, or any other system function. It only 
skips output. It does nothing else. 



NOTE 

Although you must press two keys to 
enter a control character, the system 
considers a control character as a 
single character. 



3.4.1 CTRL/C 

CTRL/C is a line terminator, 
the operating system. 



Its main use is to gain the attention of 
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In most cases, CTRL/C gives you access to the operating system without 
interrupting any tasks you may have running from your terminal. 

Typing a CTRL/C causes the CLI to prompt for command input with an 
explicit prompt. This prompt will be either DCL> or MCR> , depending 
on which CLI your terminal is set to. You can then type a command 
without interrupting any other tasks active at your terminal. 

This is particularly convenient when you want to abort a task running 
from your terminal. 

CTRL/C also assures you that the command you enter will go to DCL when 
the DCL> prompt is showing. 

If a terminal is receiving output from a task, CTRL/C interrupts that 
output. After DCL processes the input directed to it, the system 
resumes the interrupted output. No output is lost. 

CTRL/C has special effects in two cases: 

• If you have placed your VT52 in hold-screen mode with the 
command SET TERMINAL/HOLD_SCREEN, a CTRL/C and a RETURN takes 
the terminal out of hold-screen mode. It is easier to type a 
CTRL/C than to type SET TERMINAL/ NOHOLD_SCREEN . It does not 
matter whether you type in a command in response to the DCL> 
prompt; hold-screen mode is disabled anyway. Hold-screen 
mode is available in this form on VT52s only. 

• If a CTRL/S has temporarily halted the output of data to the 
terminal, a CTRL/C starts it up again. In this case, CTRL/C 
is the same as CTRL/Q. See the discussion of CTRL/S and 
CTRL/Q in the next section. 



3.4.2 CTRL/S and CTRL/Q 

This pair of control characters is used to alternately stop and start 
output to a terminal. It is particularly useful on video terminals 
where the output may go by too fast to be read, but it works on 
hard-copy terminals as well. 

CTRL/S delays the output and CTRL/Q resumes it. CTRL/C has the same 
effect as CTRL/Q. 

If you use these commands, you will not skip over any of the output. 
All output that should appear, will appear. It is simply held back 
until you are ready to look at it. (For skipping output, see the 
discussion of CTRL/0 in the next section.) 

CTRL/S can have one unexpected effect. 

fH" 4" Or\ aC **/-<n ^V <=± v.?/*\ v- 1^- i r-»^. » r^i-» v .-_*-..» 4- U »~ ~* . -. -. U -~ f 4 1 _ . ~i_l_ _.-■..__■ 
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using these commands, you will reach the end of the output and receive 
a prompt from DCL or some other system program. Since you have been 
stopping output with a CTRL/S for some time, you may type it once 
more. Then, when you try to respond to the prompt, nothing appears on 
the terminal. This is because the CTRL/S is holding back output to 
the terminal, including the echoes of what you have just typed in to 
the prompt. A CTRL/Q causes the missing echoes to appear and the 
system response follows. 
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3.4.3 CTRL/O 

This control character is used to skip over unwanted output to your 
terminal. It is analogous to the fast-forward control on a tape 
recorder . 

If you type a single CTRL/0 in response to undesired output, the 
output stops appearing on your terminal, but the system continues to 
generate the output. It can do this much faster when it does not have 
to print it on the terminal. If you type another CTRL/0, the output 
picks up at the point the operating system has reached, not the print 
at which you typed the last CTRL/0. If you do not type another 
CTRL/O, the system continues to generate the output until it reaches 
the end, whereupon a prompt appears and you may continue in response 
to the prompt. 

If you are printing multiple files on your terminal, the CTRL/O will 
be cancelled at the end of each file. For example, if you have typed 

>TYPE *,L.ST 

the system will start with the first file of the type .LST in your 
directory. If you suppress this output with a CTRL/O, the system will 
start printing again as soon as it reaches the beginning of the next 
file of the type .LST. 



3.4.4 CTRL/Z 

Typing CTRL/Z indicates end-of-file. It is used to indicate to system 
tasks, such as the MACRO-11 Assembler or the Task Builder, that you 
have finished and that the task should exit. 

A CTRL/Z in response to a prompt or at the end of a command line 
cancels the command. 

CTRL/Z is also used as a command within many system tasks, 
particularly the editors. 

If your terminal appears to be hanging, a CTRL/Z will often clear it. 

A CTRL/Z in response to a request for input from an indirect command 
file cancels the execution of the remainder of the file. 

Fundamentally, CTRL/Z signals the system that you have finished typing 
input. 



3.4.5 CTRL/O 

CTRL/U deletes the current line on your terminal. It is as if the 
line had never been typed. The system responds with a carriage return 
and a line feed so that the line can be retyped. 

If you use CTRL/U with a CREATE command when typing in a sequential 
file, the line you have deleted will appear as a blank line within the 
file. 

In three instances, a "u may appear on your terminal without your 
having typed in a CTRL/U. 
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• A system-generation option automatically sends a CTRL/U to any 
terminal that has been awaiting input past a time-out limit. 
This limit can be set by your system manager in seconds to 
anything from one second to 21 minutes. If this option is 
included, any line that is not terminated within the time-out 
limit is wiped out, as indicated by the CTRL/U that appears at 
the terminal. If you have typed in a line and then deleted it 
with the DELETE key, the system still interprets this as a 
line awaiting input and sends the CTRL/U when the time-out 
limit passes. 

• If you try to type more than 80 characters on a line without 
using a hyphen to continue the line, the system automatically 
cancels the command and indicates this by sending a *U to the 
terminal. See Section 1.2.13 for more information on line 
continuation. 

• Finally, if there is no available pool space when you type in 
a command, the system sends a ~U to your terminal informing 
you that your command has been cancelled. In this case, the 
condition will usually be corrected shortly. Try typing the 
command again. If this does not work after some reasonable 
interval, inform your system operator of the problem. 



3.4.6 CTRL/R 

Typing CTRL/R before ending a line causes the line to be retyped as it 
currently stands, that is, with any corrections you have made in it. 

This command is most useful on hard-copy terminals, where the DELETE 

key causes characters to be retyped as they are deleted. You can also 

use it on a video terminal to confirm that a line is what you think it 
is. 

For example: 

>THIMK\KM\NK EEl 
> THINK 

You may then continue typing the line. 

Although you see two copies of the line, there is only one line as far 
as the system is concerned. 

If you are typing a command on your terminal when a broadcast or 
system message arrives, you will see a ~R and a second copy of your 
command line. Simply continue typing the command. 



o A -7 r»mor /v 
j.i./ >- * ftu/ A 

A CTRL/X clears your terminal's typeahead buffer. This buffer is used 
to store input characters temporarily until your terminal can pass 
them to the operating system. 

Occasionally, this buffer gets full. When your typeahead buffer is 
full, you cannot type on your terminal and any key you strike rings 
the bell (buzzer, beeper). When this happens, type a CTRL/X and you 
may continue using your terminal. 

See Section 3.8.1, the description of the SET TERMINAL command, for 
more information on the typeahead button. 
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HELP 



3.4.8 CTRL/L 

A CTRL/L performs a form feed. Form feeds are interpreted differently 
by different kinds of output devices. A form feed will always add 
several line feeds at the point at which it is inserted. On a line 
printer, a CTRL/L will usually move the paper past the next 
perforation. 



3.4.9 Other Control Characters 

CTRL/G inserts a bell (buzz, beep) in a file or message. CTRL/G 
cannot be the first character in a line. 

CTRL/I is the same as TAB. The cursor or print head moves to the next 
tab position. Tabs are set every eight places. 

CTRL/K inserts a vertical tab by performing four line feeds. 

CTRL/M is the same as a RETURN. 



3.5 HELP 

HELP displays information about DCL and MCR commands and may display 
other information about the operating system. 

HELP is the only command that you can issue without logging in. 

Format 

>HELP[/OUTPUT:filespec] [/qualifier] [%] [parameterl] [ . . .parameter^ 

Command Qualifiers 

/OUTPUT: filespec 

/LOCAL 

/GROUP 

/CLI :cliname 

/MCR 

/DCL 

/FILErfilespec 

/filename 

Parameters 

No parameters are required for the HELP command and there are no 
prompts. You can get help on any given DCL command or subtopic, 
however, by typing a question mark (?) in response to the prompts 
from DCL. You can also get help by typing a question mark in 
response to the system prompt (>) and to the explicit DCL prompt 
(DCL>) . Examples follow at the end of this section. 
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HELP (Cont.) 



The HELP command without qualifiers or parameters displays the 
list of commands for the command line interpreter (CLI) for which 
your terminal is set, DCL, MCR, or some alternative CLI in use at 
your installation. This display contains information on getting 
more help. 

The displays for all forms of the HELP command are stored in help 
files, which are text files in help file format. See Section 
3.5.1 for information on writing help files. 



parameterl 



If you include a parameter in the HELP command, you will jump 
over the initial HELP display to a display concerning the 
parameter you have included. Examples follow at the end of this 
section. 

Usually this parameter will be a command name. When seeking help 
on a command, you should always start with a single parameter. 
The display always includes directions for getting any available 
further help. 

parameter9 

There can be up to nine levels of help. In any case, the number 
of parameters you enter determines the display shown; you always 
jump over intervening displays. See Section 3.5.1. 

Command Qualifiers 

/OUTPUT: filespec 

Permits you to name an output file where the requested help text 
is to be saved. The default is /OUTPUT:TI:. 

The following qualifiers are mutually exclusive. These qualifiers 
have the effect of naming a file where the requested help text is 
located. No matter which qualifier you use, you can still include up 
to nine parameters. 

If you are in DCL and use none of these qualifiers, the default 
command is HELP/DCL. If you are in MCR and use none of these 
qualifiers, the default command is HELP/MCR. 

/LOCAL 

% 

Specifies that the help text is in the file HELP.HLP in the 
default directory on the default volume. You can specify a local 
help file in two ways: HELP/LOCAL or HELP %. Examples follow at 
the end of this section. 



/GROUP 



Specifies that the help text is in the file HELP.HLP in the 
directory [current group, 1] on the default volume. All users 
with the same group number have access to this file by typing 
HELP/GROUP. Examples follow at the end of this section. 
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/CLI :cliname 

Specifies that the help text begins in the file LB: [1,2] cli .HLP. 
This qualifier is for installations with alternate CLIs for which 
HELP is provided. The cliname can be from 1 through 6 Radix-50 
characters. Examples follow at the end of this section. 



/MCR 



Specifies that you wish help on an MCR command. For this 
qualifier, the help text begins in the file LB: [1,2] MCR. HLP. 
This is the default for terminals set to MCR. 



/DCL 

Specifies that you wish help on a DCL command. For this 
qualifier, the help text begins in the file LB: [1,2] DCL. HLP. 
This is the default for terminals set to DCL. 

/FILE:f ilespec 

Specifies any file where help text is located. If you do not 
give a complete file specification, the defaults are 
LB: [1,2] filename. HLP. 



/filename 



Specifies that the help text begins 
when usir-f this oualif ier ,- vn:i cannot 
extension, only the filename. 



with LB: [1,2] filename. HLP. 

snor-i fu t-ho dowire. riFTi. nr 



Examples 



>HELP 

Help is avsilsble for the following DCL commands: 



ABORT 


ALLOCATE 


APPEND 




ASSIGN 


BACKUP 


BASIC 


BROADCAST 


CANCEL 




COBOL 


CONTINUE 


CONVERT 


COPY 


CREATE 




DEALLOCATE 


DEASSIGN 


DEBUG 


DELETE 


DIFFERENCES 


DIRECTORY 


DISMOUNT 


EDIT 


FIX 


FORTRAN 




HELP 


HOLD 


INITIALIZE 


INSTALL 


LIBRARY 




LINK 


LOGIN 


LOGOUT 


MACRO 


MCR 




MOUNT 


PRINT 


PURGE 


RELEASE 


REMOVE 




RENAME 


REQUEST 


RUN 


SET 


SHOW 




SORT 


START 


STOP 


TYPE 


UNFIX 




UNLOCK 




For information on a command r 


type 


HELP commsndnsme . 


Additional 


help on a 


particular etualif: 


ier is often 


available 


by tup ins! 













HELP cammandname Qualifier. 



You can also get ana DCL help on DCL commands by 
in response to s prompt. 



typinsl 
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For information on utilities? system tasks? end other system 
information* type HELP MORE* For the short forms of some 
commands ■> type HELP BRIEF. For help on logging iru type HELP 
LOGIN. 

This example shows the initial display from HELP. The user typed 
HELP without parameters or qualifiers at a DCL terminal. 

>TYPE 

F i 1 e ( s ) ? ? 



TYPEC/aual if ierCsIl filespecCsD 
/DATEtdd-mmm-yy 
/SINCE :dd-mmrn-«u 
/THROUGH idd-ramm-as 
/SINCE: dd--mifi~yy/THROUGH:dd-iiimm-yy 
/TODAY 
/EXCLUDE: filespec 

The TYPE command displays the contents of text files on your 
te rminal . 

File(s)? 

This example shows the display that results from typing in a 
question mark (?) in response to a prompt from DCL. The same 
display results from typing HELP TYPE. 

>SH0W 

Function? ? 
SHOW thins! 

The SHQU command can be used to show something* The 
following things can be shown with this command* 

ACCOUNTING ASSIGNMENTS GROUPFLAGS QUEUE LIBRARY 

CLOCK_QUEUE SYSTEM COMMON MEMORY TASKS 

DEFAULT TERMINAL DEVICES PARTITIONS 

CDAY3TIME PROCESSOR USERS 

Abbreviation! S 
Function? ?TIME 

SHOW DAYTIME 
SHOW TIME 

The SHOW TIME command displays the current time and date. 
The time is in 24 ""hour formst and the date is formatted a <s 
dd-mmm-aa . 
Function? 

This example shows the display that results from typing a 
question mark (?) and a keyword in response to a prompt from the 
SHOW command. The same display results from typing HELP SHOW 
TIME. 
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HELP (Cont.) 



3.5.1 Help File Format: Writing a Help File 

The HELP facility requires a specially formatted file or files called 
help files. A help file is a text file with up to nine levels of 
nesting. The format is much the same as a conventional outline. The 
file starts with a main topic followed by any subtopics. Each 
subtopic can include sub-subtopics, and so on through all nine levels. 

The format is the same for any help file: local, group, cli, or 
special purpose. 

You can put all help text in a single file, but for faster processing 

On larnpr hcalr* f i Toe . wnn will r\r oVjaKl \r i.ran t- 1-n nca inHl rorf 

referencing. This is explained further below. The first (or only) 
help file accessed is called the root file. 

In addition to the help text, a help file includes the numbered level 
indicators, as well as other operators to indicate synonyms and 

indirect references. The operators must appear in the first column. 

Anything else that appears in the first column is ignored by HELP. 

The help operators include the level numbers from 1 through 9, the 

number sign (#) indicating a synonym, and the at sign (§) indicating 
an indirect file reference. 

The level number in the first column must be followed by at least one 
blank or tab before the parameter. The parameter must be all 
uppercase characters without intervening blanks or tabs. Any text 
that appears before the first level-number line is printed in response 
to a HELP command without any parameters. 

Parameters at each level must have different names, but names can be 
duplicated at each different level, as shown in the example. You need 
type only the distinguishing portion of a parameter. 

HELP interprets its command line in a strictly nested fashion. When 
interpreting parameters, HELP searches down through the help file for 
the first line starting with the numeral 1 followed by the specified 
parameter. If such a line exists, HELP displays all the text between 
that line and the next level number. The lines with level numbers and 
parameters in them are never displayed. 

If you specify more than one parameter, HELP searches for a line 
starting with the numeral 1 followed by the first parameter and then 
continues the search for a line starting with the numeral 2 followed 
by the second parameter. If HELP encounters a line starting with the 
numeral 1 before encountering the appropriate level-2 line, the search 
stops. If the line starting with a 2 followed by the parameter given 
is encountered, HELP displays the text between that line and the next 
level-number line. This same procedure is followed for all nine 
parameters . 

The level-number line is not always followed by text. The following 
line may begin with a number sign (#) or an at sign (@) . If the line 
begins with a #, HELP substitutes the synonym given there for the 
original parameter and continues the search. If the following line 
begins with an @, HELP then branches to the file specified by the @ 
and continues its search in that file. 
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Ail these operators are included, with further commentary, in the 
following help file example: 

Here is the text displayed by typing HELP without parameters. 
Introductory information on the further use of the help file 
usually appears here. For better appearance, the first 
character in each line is usually a tab or blank, but there is 
no technical requirement that you do this. The HELP processor 
ignores any first character except the numerals 1 through 9 
and the symbols @ and #. It is good practice to limit text to 
about 20 lines so that the display text can be displayed on a 
video terminal without scrolling and with room left to enter a 
command without losing help text. Text at each level should 
refer to all help available at the next level. 

Further help is available. Type 

HELP FIRST-LEVEL1 HELP SECOND-LEVEL1 

HELP INDIRECT HELP SYNONYMS 

HELP PURPLE HELP MAOVE 

1 FIRST-LEVEL1 

This is the first level-1 help text. The first line of this 
text must begin with the numeral 1. This is the text 
displayed if you type 

>HELP FIRST-LEVEL1 

The parameter must be all uppercase characters (CAPITALS) . It 
is not necessary to type the full text of the parameter to 
display the text, but you must type enough of it to 
distinguish the parameter from all other parameters at the 
same level. In this example, typing 

>HELP FIRST 

would be enough. The parameter must be separated from the 
level number by one or more blanks or tabs. The parameter 
itself cannot include any blanks or tabs, but phrases can be 
tied together with hyphens or underscore characters. If you 
do this, make it clear in your reference to that level. 

Further help is available. Type 

HELP FIRST-LEVEL1 FIRST-LEVEL2 

2 FIRST-LEVEL2 

This is the text displayed if you type HELP FIRST FIRST. This 
is the first level-2 help text. 

1 SECOND- LEVEL1 

This is the text displayed if you type HELP SECOND. This is 
the second level-1 help text. 

Further help is available. Type 

HELP SECOND-LEVELl SECOND-LEVEL2 
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2 SECOND-LEVEL2 

This is the text displayed if you type HELP SECOND SECOND. 
This is the second level-2 help text. 

1 INDIRECT 

Help files can also include indirect references to other help 
text. These indirect references greatly decrease search time 
because once the HELP processor sees the indirect reference, 
the calling file (this file) is left behind. The filespec can 
be any legal filespec. The default file type is .HLP. If you 
use a file type other than .HLP, that type becomes the default 
file type for that session of HELP- 

The file referred to in this manner has the same format as 
other help files, except that if the indirect file contains 
level numbers, these must be greater than the level number in 
the calling file. For instance, if the calling file contains 
the lines 

1 INSTANCE 
@ INSTANCE 

then INSTANCE. HLP can contain only level numbers 2 through 9. 

Further help is available. See 

HELP INDIRECT EXAMPLE 

2 EXAMPLE 
6EXAMPLE.HLP 

1 SYNONYMS 

HELP also permits cross-references between two or more similar 
or synonymous parameters. The format for synonyms appears 
below. You can greatly assist the user by trying to imagine 
what might be typed in seeking particular help text and 
including the most likely possibilities as synonyms. 

The synonyms must all precede the main entry to which they 
refer. The main entry and all synonym entries must have the 
same level number . 

1 MADVE 
# PURPLE 



1 MAGENTA 
fPORPLE 



1 PURPLE 

Color of a hue between blue and red. Shades of purple include 
mauve, violet, plum, lilac, puce, amethyst, and magenta. 
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3 . 6 BROADCAST 

BROADCAST displays a specified message at one or more terminals. 

Format 

BROADCAST 
To? [ttnn:] 
Message? message 

BROADCAST/gualif ier 
Message? message 

BROADCAST username me'ssage 

BROADCAST @filespec 

Command Qualifiers 

/ALL 
/LOGGED_IN 

Parameters 

message 

The message must fit on a single line, but the final character 
can go in column 80. The message can include any printing 
character. Lowercase letters are converted to uppercase. 

If you do not specify a destination for the message, the message 
is sent to pseudo device CO:, the operator's console. This is 
the equivalent of the REQUEST command. See Section 3.7. 



ttnn: 



Specifies the terminal to which you wish the message to be sent. 
Terminals need not be logged in to receive messages, but they 
must be turned on (powered) . 



iiJi-^rn.i-.o 



On RSX-11M-PLOS systems only, specifies the user to whom you wish, 
the message to be sent. The message goes to all terminals the 



< u ..A 



@f ilespec 



Specifies the name of an indirect command file. All users can 
send multiple messages or multiple copies of the same message 
using this method. The file should contain messages in the 
following format: 

TTnn:message 

Privileged users can also use the privileged qualifiers in the 
following formats: 



LOGGED_IN :message 
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The indirect command file cannot include any Indirect directives 
or labels, only destinations and messages. The destination 
cannot be preceded by tabs or blanks . 

Command Qualifiers 

/ALL 

This privileged qualifier sends the same message to all powered 
terminals, excluding slaved terminals. 

/LOGGED_IN 

This privileged qualifier sends the same message to all logged-in 
terminals. 

Examples 

^-BROADCAST 
To? TT20J 
Message? Meet me in the alley behind the barn. 

The message is printed on TT20: 

30-0CT-82 FROht TT10. TO. TT20t 

MEET ME IN THE ALLEY BEHIND THE BARN. 



As the message arrives, the terminal's audio signal sounds. 
Notice that the message is printed in uppercase characters on the 
receiving terminal. 

>BROADCAST TT12. THIS IS A ONE-LINER* 

This is the one-line form of the command. 

>BROADCAST/LOGGEB_.IN 

Messsae? Everybody take the rest of the day off* 

The message is printed on all logged-in terminals. This is a 
privileged command. 

>BR0 ODAILY 

The file DAILY.CMD contains the following messages: 

TTlltWHERE IS THE DITKO CONTRACT? 

TT13.MEET ME FOR LUNCH AT 11(30 

TT27.THE QUICK BROWN FOX JUMPED OVER THE LAZY DOG 

TT35:GET BACK TO WORK 

TT41.I LOST MY GREEN EYESHADE* HAVE YOU SEEN IT? 

The messages are sent to the designated terminals. Privileged 
users can also include messages preceded by ALL: and LOGGED_IN:. 
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Notes 

B is the short form of BROADCAST. 

Only terminals can receive messages. 

If you wish your message to include lowercase characters when 
printed, enclose the message in "quotes." 

If the message cannot be broadcast within 10 seconds, the system 
displays the following message at the initiating terminal: 

BRO — Terminal is busy — TTnn: 

If a user specifies multiple destinations, the system returns an 
error message for each busy terminal. 

The BROADCAST command uses the write-breakthrough feature of the 
terminal driver. This means the message breaks through any kind 
of I/O at the destination terminal. If you are editing, for 
instance, the message may appear in the middle of your text, but 
in fact it has no effect on the text you are editing. You can 
issue a SET TERMINAL/NOBROADCAST command if you do not wish to 
receive broadcasts. See Section 3.8.1. 

This command invokes the MCR BRO task. 

Error Messages 

BRO — Command input error 

Explanation: The BROADCAST task did not receive the command 
line. 

User Action: Often this message results from a missing indirect 
command file. Locate the file; or, check for proper syntax and 
enter the command again. 

BRO — Command syntax error 

Explanation: The command syntax was not correct. 

Dser Action: Check for proper syntax and enter the command 
again. 

BRO — Illegal device specified 

Explanation: The destination device was not a terminal. 

Dser Action: Check for proper device and enter the command 
again. 

BRO — Privileged command 

Explanation: Nonprivileged users cannot send messages to all 
connected or logged-in terminals. 

User Action: Use an indirect command file to send messages to 
multiple terminals from a nonprivileged terminal. 
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BRO — User not receiving messages 
BRO — TTnn:message 

Explanation: The message was sent to a terminal set to 
NOBROADCAST. 

User Action: Wait and try again. 

3.7 REQUEST 

REQUEST sends a message to pseudo device CO:, the operator's terminal. 

Format 

REQUEST 

Message? message 

REQUEST message 

Parameter 

message 

The message must fit on a single line, but the final character 
can go in column 80. The message can include any printing 
character. Lowercase letters are converted to uppercase. 

The message is time-stamped and indented on the operator's 
terminal . 

Example 

>REQUEST Charlie* the tape drives are down asSsin. 

The message appears on the operator's console in the following 
format: 



13:30:45 LosSin user ISHMAEL 
1.3:32:45 Losi in user MOBYDICK 



13:32M7 



12-SEP-82 FROM: TT56t TO! CO: 

CHARLIEt THE TAPE DRIVES ARE DOWN AGAIN 



13136522 Login user GUEEQUEG 
14*,36:42 Login user PEQUOD 



The user at TT56: observed a problem on the system and reported 
it to the operator with REQUEST. The message appears on the 
operator's console, time-stamped and indented so that it stands 
out from other messages. 
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Notes 



The REQUEST command is very similar to the BROADCAST 
The main difference is that no destination is required. 



command , 



CO: is usually, but not always, TTO:. In most installations, 
however, any REQUEST message will come to the attention of the 
operator or system manager . 



See the discussion of COT, the Console Output 
RSX-11M/M-PLUS System Management Guide for more 
CO:. 



Task, in the 
information on 



3.8 SET AND SHOW TERMINAL 

SET TERMINAL and SHOW TERMINAL are complementary commands. SET 
TERMINAL sets terminal characteristics and SHOW TERMINAL displays 
information about terminal characteristics. For detailed information 
about these characteristics, see the discussion of the full-duplex 
terminal driver in the RSX-11M/M-PLUS I/O Drivers Reference Manual . 



3.8.1 SET TERMINAL 

SET TERMINAL sets various attributes of your terminal 
users can set attributes for any terminal. 

Format 

SET 

Function? TERMINAL! :TTnn: ] 

Terminal Attribute? attribute[/attribute[s] ] 

SET TERMINAL [:TTnn:] [/attribute] [/attribute[s] ] 

Attributes 



Privileged 



Group 1: Common Use 

/[NO] LOWERCASE 

/[NO]HOLD_SCREEN 

/DCL 

/[NO] PRIVILEGED 

/ rNOl RRDADCAST 



/[NO] UPPERCASE 

/MCR 

/SPEED: (transmit , receive) 

/CLI :cliname 

/WIDTH :n 



Group 2: Terminal Setup 

/ASR33 /VT05B 

/ASR35 /VT50 

/KSR33 /VT52 

/KSR35 /VT55 

/LA12 /VT61 

/LA30P /VT100 

/LA30S /VT101 

/LA34 /VT10 2 

/LA36 /VT105 
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/LA38 
/LAI 00 

/LA120 
/LA180S 

/[NO]HARDCOPY 
/CRFILLrn 
/[NO]FORM_FEED 
/PAGE_LENGTH:n 
/[NO] AUTOBAUD 

Group 3; Task Setup 

/[NO] ECHO 
/[NO]FULL_DUPLEX 
/[NO] INTERACTIVE 
/[NO] LOCAL 
/[NO]TYPEAHEAD[:n] 
/[NO] EIGHT BIT 



/VT125 
/VT131 
/VT132 



/[NO] SCOPE 
/LFFILL 
/[NO] TAB 
/MODELrarg 



/[NO] ESCAPE 
/[NO]PASSALL 
/[NO] REMOTE 
/[NO] SLAVE 
/[NO] WRAP 
/[NO] SERIAL 



Command Option 

TTnn: 



Specifies the terminal for which an attribute is to be set. 

For nonprivileged users, only your own terminal number or TI: is 
permitted here. Since TI : is the default:, nonprivileged users 
need not give a terminal number. Privileged users can name any 



terminal 
Attributes 



You can set several attributes at once. This results in several 
commands queued to MCR. If one of these commands fails, all 
others following it in the command line also fail. 

Group 1: Common Dse 

The following parameters set terminal characteristics that are 
regularly needed by the average terminal user. 

/UPPERCASE 
/NOLOWERCASE 

/UPPERCASE is the default. All characters typed on the terminal 
appear in uppercase. /NOLOWERCASE is the same as /UPPERCASE. 

/LOWERCASE 
/NOUPPERCASE 

Characters typed on the terminal in lowercase appear in 
lowercase. It is common practice to set terminals to lowercase 
in a LOGIN.CMD file. Most system tasks will accept input in 
lowercase. Note that some terminal escape sequences use 
lowercase characters. If, for instance, the keypad commands in 
EDT do not seem to be working, you may have to set the /LOWERCASE 
attr i hiite , 
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/[NO]HOLD_SCREEN 

Sets a VT50, VT52, or VT55 terminal to HOLD_SCREEN. 

Video terminals can present output much faster than you can read 
it. HOLD_SCREEN lets you accept output on your VT50 , VT52, or 
VT55 terminal one line or one screenful a time. 

/NOHOLD_SCREEN is the default. Output appears at the bottom of 
the screen and scrolls off the top at the rate it is sent to the 
terminal . 

/HOLD_SCREEN first clears the screen, then fills in from the top 
of the screen to the bottom and stops. If you want to see 
another line, press the SCROLL key once. If you want to see 
another screenful, press the SCROLL key while holding down the 
SHIFT key. Data is being held back. It is not being lost. 

If you want to disable HOLD_SCREEN, either issue SET TERMINAL/ 
NOHOLD_SCREEN or press CTRL/C. 

You can also control output with the CTRL/S and CTRL/Q keys. On 
terminals in the VT100 series, you can use the NO SCROLL key. 
See Section 3.2.6 for more information. 



/MCR 



Sets terminal to MCR. Terminal no longer accepts DCL commands. 
The counteracting MCR command is SET /DCL=TTnn:. 

/DCL 

Sets terminal to DCL. Since this is a DCL command, it is mainly 
useful for privileged users who wish to set some other terminal 
to DCL, but it is not a privileged command. 

/SPEED: (transmit , receive) 

Sets terminal's rates for transmission and reception of data. 
This software speed setting must be matched by the hardware speed 
setting, which is controlled by switches on the terminal itself. 
The first number in parentheses is the transmission rate, the 
second is the reception rate. Note the use of the comma. When 
you issue SHOW TERMINAL/SPEED, the output has a colon separating 
the two rates, but when you issue SET TERMINAL/SPEED, you must 
separate the two rates with a comma. See the examples. 

Rates are expressed in baud, or bits per second. A rate of 110 
baud is the equivalent of 10 characters per second. For baud 
rates above 110, the rate divided by 10 is the equivalent in 
characters per second. Thus, 300 baud, the usual LA36 rate, is 
equivalent to 30 characters per second, and 9600 baud, the usual 
video terminal rate, is equivalent to 960 characters per second. 

In any case, you are limited to the hardware speed settings for 
your terminal. See the documentation provided with your 
terminal, or your system manager, for further information. 
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/[NO] PRIVILEGED 

Sets a terminal privileged or nonprivileged . A privileged 
terminal can issue all DCL and MCR commands. The default is 
determined by whether you log in privileged or nonprivileged. 
Privileged users are those whose UIC has a group number equal to 
or lower than 10. (The group number is the first number of the 
UIC.^ Setting this attribute is a privileged option. 

/CLI :cliname 

Sets a terminal to an alternate command line interpreter (CLI) . 
The cliname is from one to six Radix-50 characters. See your 
system manager for information on any alternative CLIs at your 
installation. 

/[NO] BROADCAST 

Establishes whether you wish to receive broadcast messages on 
your terminal. The default is to receive broadcasts. 

This attribute restricts messages from BROADCAST and SHUTUP only. 
All BROADCAST messages are intercepted when you set your terminal 
/NOBROADCAST. Senders are notified that you are not receiving 
messages. See the examples. As for SHUTUP, all messages about 
the pending shutdown of the system are intercepted except those 
issued in the last five minutes of SHUTUP. These are the only 
messages intercepted when you set your terminal /NOBROADCAST. 
Messages iroiii otuer tasrcs are no*. oilcCi-cG. 

/WIDTH:n 

The SET TERMINAL/WIDTH command sets the width of your terminal, 
that is, the length of a line, n can be from through 132. 
Note that a line length of zero means no commands can be entered 
on the terminal. 

Group 2: Terminal Setup 

The following qualifiers set hardware characteristics of 
terminals. For certain common models, you can set a number of 
characteristics automatically simply by identifying the model. 
For other terminals, you must set these characteristics 
explicitly, or alter the terminal driver to recognize them. 

Here are the models for which automatic setup is provided: 

KSR33 

LA30P 

LA36 

LA120 

VT50 

VT61 

VT102 

VT131 



ASR33 


ASR35 


KSR35 


LA12 


LA30S 


LA34 


LA38 


LA100 


LA180S 


VT05B 


VT52 


VT55 


VT100 


VT101 


VT105 


VT125 


VT132 
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Most of these are DIGITAL terminals. Those with "LA" 

designations , are hard-copy terminals; those with "VT" 

designations are video models. Those with "SR" follow the 
Teletype! pattern. 

Setting a terminal to a particular model does not mean that the 
terminal will behave like that model. It means only that the 
operating system will treat the terminal as if it were that 
model. This feature is intended primarily to deceive tasks that 
expect a certain terminal model or to identify a terminal as to 
what it is. 

You can set hard-copy terminals as video terminals and you can 
set video terminals as hard-copy terminals. For the terminal 
user, the most noticeable difference will be in the way the 
DELETE key operates. Setting terminals from hard-copy to video 
may prove disruptive; setting terminals from video to hard-copy 
is less likely to cause trouble. 

Setting a terminal to a particular model designation 
automatically sets a number of attributes for the terminal. See 
the RSX-11M/M-PLUS I/O Drivers Reference Manual for complete 
information on the settings for each terminal model. 

You can also set these attributes individually. Nonprivileged 
users can set them for their own terminals; privileged users can 
set them for any terminal. 

The defaults for these attributes depend on how your terminal is 
known to the system when you log in. You can find out how your 
terminal is known to the system by logging in and issuing a SHOW 
TERMINAL command. 



/NOHARDCOPY 
/SCOPE 



Sets terminal as a video terminal. /SCOPE is the equivalent of 
/NOHARDCOPY. 



/HARDCOPY 
/NOSCOPE 



Sets terminal as a hard-copy terminal. /NOSCOPE is the 
equivalent of /HARDCOPY. 



/[NO] AUTOBAUD 



iuc / c*\j i \jLjn.\ju (juai j. j- j. c= j. cuauxco auu*-iuauu uctcuiiun kjii a tcmu^c 

dial-up line. This means that when a remote terminal dials up, 
the terminal driver samples the first character sent along the 
line to determine the incoming baud rate and sets the interface 
speed accordingly. The default is /NOAUTOBAUD. 



1. Teletype is a trademark of the Teletype Corporation, 
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/CRFILLm 



Sets the attribute used to accommodate the 
carriage-return/line-feed process on hard-copy terminals. While 
the terminal is performing the line feed, a number of null 
characters may be needed to fill in for the time the terminal is 
not capable of accepting new characters. The value n can be any 
number from through 7. 



/LFFILL 



Sets the attribute used to accommodate vertical spacing on 
terminals. While the terminal is performing a vertical tab, line 
feed, or form feed, four null characters are sent to fill in for 
the time the terminal is not capable of accepting new characters. 



/[NO] FORMFEED 



If the terminal hardware supports form feeds, the terminal should 
be set /FORMFEED. If form feeds are handled by the software 
providing line feeds, the terminal should be set /NOFORMFEED. 



/[NO] TAB 



If the terminal hardware supports horizontal tabs, the terminal 
should be set TAB. If tabs are handled by the software providing 
spaces, the terminal should be set NOTAB. 



/PAGE LENGTH :n 



Defines the number of lines to a page. By convention, a page is 
usually considered the number of lines to a screenful on video 
terminals or the number of lines between perforations on 
hard-copy terminals. This attribute sets the length of the page. 
(Width is set through the SET DEVICE command, Section 5.10.2.) 



/MODEL :n 



This parameter is used primarily to identify terminals that are 
not on the automatic setup list. Your system manager will tell 
you if you need to use this parameter. 



SYSTEM MANAGERS 

n can be any decimal number from through 255 (0-377 
octal) . The first half of these numbers (0-127 decimal 
or 0-177 octal) is reserved for use by DIGITAL. Each of 
the terminals on the automatic setup list is assigned one 
of these numbers. The second half (128-255 decimal or 
200-377 octal) is available for other terminals. 

Setting a terminal with an /MODEL value has little effect by 
itself. If the /MODEL value is that of one of the terminals on 
the automatic setup list, the effect will be the same as setting 
the terminal to that model. If the /MODEL value is unused, then 
setting the terminal to that value affects nothing but the output 



f 



rom SHOW TERMINAL/MODE! 
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If you wish automatic setup for those terminals not included in the 
automatic setup list, you can add /MODEL values to the table in 
SYO: [11,10] TTDAT. MAC and then reassemble and relink the terminal 
driver with the new table. Procedures for adding entries to the table 
are given in the comments in TTDAT. MAC. 

If you do this, a SET TERMINAL/MODEL command with the proper 

value will set up such a terminal automatically. you cannot 

identify such terminals by a name; only a /MODEL value is 
permitted. 

Group 3: Task Setup 

The following parameters set terminal characteristics that may be 
needed by system or user tasks. Most system tasks that require 
these attributes in a terminal will set the attributes when they 
attach the terminal. User tasks can also do this. This will be 
transparent to the user. These parameters are included for use 
in cases where the task does not do this setting. See the 
RSX-11M/M-PLUS I/O Drivers Reference Manual for information on 
how tasks can set terminal attributes . 

/[NO] ECHO 

Enables (or disables) echoing of characters typed on the 
terminal . 

/ECHO is the default. Characters typed on the terminal are 
echoed on the terminal. 

/NOECHO suppresses the echo. (The system task LOGIN uses this 
feature to keep passwords secret.) 

/NOECHO changes nothing but echoing. Commands can still be 
passed to the system, but the system passes no echo back. 

/[NO] ESCAPE 

Enables (or disables) recognition of escape sequences from a 
terminal. 

/NOESCAPE is the default. When you press the ESC (SEL, ALTMODE) 
key, it is interpreted as a line terminator (with a line feed but 
no carriage return) . 

ESCAPE enables the recognition of escape sequences from the 
terminal. When you press the ESC (SEL, ALTMODE) key, it is 

.. i. *_*- a. £r±. s_ ^v^vx w*j v-i»^ wcvjiiuiiiiy \j j. a u ^ov^ci^c: sequence • iue Cioo i^wy 

will no longer terminate a line. 

This is a rarely used parameter. Most tasks that recognize 
escape sequences will attach the terminal so that escape 
sequences are passed without the user's knowledge, usually from 
the keypad . 
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/[NO]FULL_DUPLEX 

Enables (or disables) full-duplex mode at a terminal. 

/NOFULL_DUPLEX is the default. The terminal cannot accept input 
and receive output at the same time. "Half-duplex" is the usual 
industry term for this attribute. 

/FULL_DUPLEX allows the terminal to accept input and receive 
output at the same time. This attribute is useful where echoing 
is not required, with split-screen applications, and when the 
terminal is communicating with some full-duplex device. 

/NOPASSALL 
/INTERACTIVE 

Specifies that any characters typed on the terminal should be 
interpreted by the terminal driver before they are sent to a 
task. CTRL/A is accepted as a command to an interactive 
terminal. NOPASSALL is the same as INTERACTIVE. This is the 
default setting. 

/PASSALL 

/NOINTERACTIVE 

Specifies that characters sent by the terminal should not be 
interpreted by the terminal driver. Therefore, the task must 
interpret all characters. CTRL/A may be a command to a task, in 

t-Vti c: r~3Qtfa . Vm+- mt 1 T nrtK a ffar--¥ J-hcs n r-. o *- a t- -i nn Cwefom TVii c- 

parameter automatically sets the terminal to the /EIGHT_BIT 
attribute. 

/NOREMOTE 
/LOCAL 

Specifies that the terminal is not attached to a dial-up line. 
/NOREMOTE is the same as LOCAL. This is the default setting. 

/REMOTE 
/NOLOCAL 

Identifies a terminal number with a dial-up line. A user can 
call in and attach a remote terminal. /REMOTE is the same as 
/NOLOCAL. 

This keyword has nothing to do with the LOCAL/REMOTE switch found 
on some terminals, which sets the terminal as a typewriter 
(LOCAL) or terminal (REMOTE) , nor does it have anything to do 
with DECnet host terminals. 

/[NO] SERIAL 

This qualifier is for RSX-11M-PL0S systems only. The default is 
/NOSERIAL. When you enter a command before the previous command 
has completed execution., the second command is processed in 
parallel with the first. 
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Setting the terminal /SERIAL means that the first command 
completes execution before the: second is passed to the system. 
When a terminal is sei /SERIAL,, commands are retained in the 
terminal's typeahead buffer until it is time foe ; hem to be 
passed to the? system,. See ..be die-cation of /TYPEAHEAD for 
information on how to change the size of the r--r.ii > nal s ! yp^-ahead 
"buffer:."/; '"// ■ 

/[NO] SLAVE 

Enables (or disables) slave status at a terminal. 

/NOSLAVE is the default. The terminal can both send unsolicited 
input and receive system output. The user has full access to all 
facilities of the terminal. 

This is a rarely used parameter. Most tasks that need a slave 
terminal will attach the terminal without specific action by the 
user . 

This parameter is not privileged, but if you set your terminal 
/SLAVE, you will need to go to a privileged terminal to set the 
terminal back to /NOSLAVE. 



This qualifier has different effects on RSX-11M and RSX-11M-PLUS. 

On RSX-11M systems, the /TYPEAHEAD qualifier enables or disables 
the terminal's typeahead nt. vrihci.p. /TYi'flAHEAn is the default. 
The te minal accepts input faster than it can send it. While 
waiting to be sent, this input is stored in the terminal's 
typeahead buffer, which holds 36 characters. This buffer size 
cannot be changed on r.sv-MM; nc numerical argument is accepted. 
If the buffer yets full, the terminal no longer accepts 
unsolicited input. When the buffer is full, the characters you 
type are no longer echoed, end the bell (buzzer, beeper) sounds 
each ti'iie you press 3 key. Yon can clear the typeahead buffer 
with a CTRL/X. /NOTYPEAIIEAD disables this feature. The terminal 
driver cananl store characters and excess characters are lost. 

On RSX-11M-PLDS systems, the /TYPEAHEAD qualifier enables or 
disables the terminal's typeahead attribute and also sets the 
size of the typeahead buffer. /TYPrtAHEAD: 86 is the default. The 
terminal accepts input faster than it can send it. While waiting 
to be sent, this input is stored in the typeahead buffer. If the 
buffer gets full, the terminal no longer accepts unsolicited 
input. When the buffer is full, the characters you type are no 
longer echoed, and the bell (buzzer, beeper) sounds each time you 
press a key. You can clear the typeahead buffer with a CTRL/X. 
/NOTYPEAHEAD disables this feature. The terminal driver cannot 
store characters and excess characters are lost. 

On RSX-llM-PLUS systems, you can set the size of the typeahead 

buffer from through 255. If your terminal is set /SERIAL, you 

may wish to increase the size of the typeahead buffer so you can 
queue more- commands'. 
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/[NO] WRAP 

Specifies that the terminal automatically wrap (or not wrap) 
lines longer than its line width. 

/WRAP is the default. The terminal automatically issues a 
carriage return and a line feed when you type to whatever line 
width the terminal is set for. 

/NOWRAP overrides this feature and permits unlimited line length. 

/[NO] EIGHT_BTT 

Enables (or disables) a terminal's /EIGHT_BIT attribute. 

/NOEIGHT_BIT is the default. DIGITAL software employs 7-bit 
ASCII (without parity checking) . 

/EIGHT_BIT allows the terminal to pass all eight bits of the 
ASCII character. This attribute is used when your terminal is 
communicating with some device that sends 8-bit ASCII. 

Examples 

>SET 

Function? TERMINAL 

Attribute? LOWER 

This example sets the /LOWERCASE attribute for the issuing 
terminal. Lowercase characters sent from the terminal will not 
be converted to uppercase. Most system tasks will accept 
commands in lowercase. The EDT keypad commands will not work 
unless your terminal is set /LOWERCASE. 



>SET TERMINAL/LOWER 

This example is equivalent to the previous- one. 
frequently included in a LOGIN.CMD file. 



This command is 



>SET TERMINAL/VT52 

This example sets the issuing terminal as a VT52. The operating 

system "sees" the terminal as a VT52. If it is in fact a 

hard-copy terminal, output to the terminal may be garbled and the 

terminal may seem to jam. This command sets a number of 

defaults. These are shown in Table 3-2. 



>SET TERM/LA36 

This example sets the issuing terminal as an LA36. The operating 
system "sees" the terminal as an LA36. If it is in fact a video 
terminal, the only noticeable side effect will be the reprinting 
of characters deleted by the DELETE key. This command sets a 
number of defaults. These are shown in Table 3-2. 
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>SET TERil/SPEEDi (ii0f300) 

This example sets the issuing terminal to transmit at 110 baud 
and receive at 300 baud. The acceptable values for transmit and 
receive rates are inherent in the design of the terminal and 
other hardware. See the documentation provided with your 
terminal. After issuing this command, the user must reset the 
hardware to the same transmit and receive rates. You must issue 
the SET TERMINAL command first and then set the hardware so that 
the terminal driver can communicate with the terminal. 



>SET TERMINAL/LA36/SPEED! < 300 , 300 ) /NOBROADCAST 

This example sets the issuing terminal as an LA36, sets its speed 
to 300 baud for both transmit and receive, and inhibits 
broadcasting to the terminal. 

>SET TERHINAL/SERIAL/TYPEAHEAB5 150 © 
>macro/show:all PETE* JOHN, ROGER, KEITH (E) 
link/task:who keith © 

RUN WHO @T) 

In this example, the User set his terminal /SERIAL and increased 
the size of the typeahead buffer. The user then entered a MACRO 
command, followed by a LINK command and a RUN command. The 
commands are separated by RETURNS. The LINK command cannot 
execute until the assembly completes, and the RUN command cannot 
execute until the task build completes. In fact, the LINK 
command is not even echoed until the MACRO command completes and 
the same is true for the RUN command. The unexecuted commands 
are stored in the typeahead buffer. 



Note 



You can find how all attributes are set for your terminal with an 
unadorned SHOW TERMINAL command. See Section 3.8.2. 



3.8.2 SHOW TERMINAL 

SHOW TERMINAL displays information about your terminal and the other 
terminals on your system. 



Format 



BHOW 

Function? TERMINAL [: TTnn: ] 



SHOW TERMINAL [: TTnn:] [/attribute] [/attributed] 

Attributes 

/[NO] LOWERCASE / [NO] UPPERCASE 

/[NO]HOLD_SCREEN /DCL 

/MCR " /SPEED 

/[NO] PRIVILEGED / [NO] BROADCAST 

/LOGGED ON /CLI:cliname 
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/[NO] ASR33 


/[NO] ASR35 


/[NO]KSR33 


/[NO]KSR35 


/[NO]LA12 


/[NO]LA30P 


/[NO]LA30S 


/[NO]LA34 


/[NO]LA36 


/[NO]LA38 


/[NO]LA100 


/[NO]LA120 


/[N0]LA180S 


/[NO]VT05B 


/[NO]HARDCOPY 


/CRFILL 


/[NO] FORM FEED 


/PAGE LENGTH 


/[NO] ECHO 


/[NO] FULL DUPLEX 


/[NO] INTERACTIVE 


/[NO] LOCAL 


/[NO]TYPEAHEAD 


/[NO]EIGHT BIT 


/HT 


/TT 


Command Option 


TTnn: 



/[NO] 
/[NO] 
/[NO] 
/[NO] 
/[NO] 
/[NO] 
/[NO] 
/[NO] 
/[NO] 
/[NO] 
/•NO] 



VT50 

VT52 

VT55 

VT61 

VT100 

VT101 

VT102 

VT105 

VT125 

VT131 

VT132 



/[NO] SCOPE 
/LFFILL 
/[NO] TAB 
/MODEL 

/[NO] ESCAPE 
/[NO]PASSALL 
/[NO] REMOTE 
/[NO] SLAVE 
/[NO] WRAP 
/[NO] AUTOBAUD 
/VT 
/TI: 



Identifies the terminal about which you wish to display 
information. The default is TI : . 

An unadorned SHOW TERMINAL command, such as the following: 

>SHOW TERMINAL 

or 

>SHOW TERMINAL:TT56: 

displays all the attributes set for your terminal or the terminal 
you name. See the examples. 

SHOW TERMINAL/ALL displays information about all terminals on the 
system. 



Attributes 



Each SHOW TERMINAL attribute is directly related to a SET 
TERMINAL attribute. The meaning of each attribute is discussed 
in its place under SET TERMINAL in Section 3.7.1. In addition, 
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each SHOW TERMINAL attribute can have a NO in front of it to 
allow you to determine which terminals do not have a particular 
attribute. 

You can include more than one attribute in your SHOW TERMINAL 
command. This is the equivalent of entering a series of SHOW 
TERMINAL commands. That is, the command 

>SHOU TERHINAL/LA36/DCL 

displays a list of all LA36s on your system and a list of all 
terminals set to DCL, but NOT a list of all LA36s set to DCL. 

The displays returned by SHOW TERMINAL do not necessarily match 
the attribute names used in DCL. For instance, the command 

>SHQW TERHINAL/HARDCOPY 

causes a display labeled NOCRT, meaning that the terminal is not 
a cathode-ray terminal. 

The same display results from 

>SH0W TERMINAL/NOSCOFE 

Table 3-2 shows the relationships between SHOW TERMINAL and its 
displays, and SET TERMINAL. For further information on the 
displays, see the examples. 

/HT 
/TI: 
/TT 
,/VT 

These qualifiers display information about particular types of 
terminals on the system. /HT displays a list of DECnet host 
terminals. /TI: is the same as SHOW TERMINAL without any 
qualifier. /TT displays a list of real terminals on the system. 

/VT displays a list of virtual terminals on an RPX-11M-PLUS 

■ system-;' ' 

If your SHOW TERMINAL command produces only a prompt and no output, 
there are no terminals on the system that match the attribute given in 
your command . 



Table 3-2 
Display of Terminal Attributes from SHOW TERMINAL 



SHOW TERMINAL 
Attribute 



SHOW TERMINAL 
Display 



SET TERMINAL 
Attribute 



AUTOBAUD 
DCL 



ABAUD= 
DCL= 



AUTOBAUD 
DCL 
(continued on next page) 
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Table 3-2 (Cont.) 
Display of Terminal Attributes from SHOW TERMINAL 



SHOW TERMINAL 
Attribute 


SHOW TERMINAL 
Display 


SET TERMINAL 
Attribute 


ECHO 


ECHO= 


ECHO 


EIGHT_BIT 


EBC= 


EIGHT_BIT 


ESCAPE 


ESCSEQ= 


ESCAPE 


FORM FEED 


FORMFEED= 


FORM FEED 


FULL_DUPLEX 


FDX= 


FULL DUPLEX 


HARDCOPY 


NOCRT= 


HARDCOPY 
NOSCOPE 


CRFILL 


HFILL= 


CRFILL 


HOLD SCREEN 


HOLD= 


HOLD_SCREEN 


INTERACTIVE 


NORPA= 


INTERACTIVE 
NOPASSALL 


LOCAL 


NOREMOTE= 


LOCAL 
NOREMOTE 


LOWERCASE 


LOWER= 


LOWERCASE 


NOECHO 


NOECHO= 


NOECHO 


NOEIGHT BIT 


NOEBC= 


NOEIGHT_BIT 


NOESCAPE 


NOESCSEQ= 


NOESCAPE 


NOFORM_FEED 


NOFORMFEED" 


NOFORM_FEED 


NOFULL_DUPLEX 


NOFDX= 


NOFULL_DUPLEX 


NOHARDCOPY 


CRT= 


NOHARDCOPY 
SCOPE 


NOHOLD_SCREEN 


NOHOLD= 


NOHOLD_SCREEN 


NOINTERACTIVE 


RPA= 


NOINTERACTIVE 
PASSALL 


NOLOCAL 


REMOTE= 


NOLOCAL 



REMOTE 



(continued on next page] 



3-46 



TERMINAL OPERATIONS 



SHOW TERMINAL (Cont.) 



Table 3-2 (Cont.) 
Display of Terminal Attributes from SHOW TERMINAL 



SHOW TERMINAL 
Attribute 


SHOW TERMINAL 
Display 


SET TERMINAL 
Attribute 




NOLOWERCASE 


NOLOWER= 


UPPERCASE 




NOPASSALL 


NORPA= 


NOPASSALL 
INTERACTIVE 




NOPRIVILEGE 


NOPRIV= 


NOPRIVILEGE 




NOREMOTE 


NOREMOTE= 


NOREMOTE 
LOCAL 




NOSCOPE 


NOCRT= 


NOSCOPE 
HARDCOPY 




NOSLAVE 


NOSLAVE= 


NOSLAVE 




NOTAB 


NOHHT= 


NOTAB 




NOTYPEAHEAD 


NOTYPEAHEAD= 


NOTYPEAHEAD 




NOUPPERCASE 


LOWER= 


LOWERCASE 




NOWRAP 


NOWRAP= 


NOWRAP 




MCR 


MCR= 


MCR 




MODEL 


TERM= 


MODEL 




PAGE_LENGTH 


LINES= 


PAGE_LENGTH 




PASSALL 


RPA= 


PASSALL 
INTERACTIVE 




PRIVILEGE 


PRIV= 


PRIVILEGE 




REMOTE 


REMOTE= 


REMOTE 
NOLOCAL 




SCOPE 


CRT= 


SCOPE 
NOHARDCOPY 




SLAVE 


SLAVE= 


SLAVE 




SPEED 


SPEED= 


SPEED 




TAB 


HHT= 


TAB 




TYPEAHEAD 


TYPEAHEAD= 


TYPEAHEAD 




UPPERCASE 


NOLOWER= 


UPPERCASE 










na.-rol 
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Table 3-2 (Cont.) 
Display of Terminal Attributes from SHOW TERMINAL 



SHOW TERMINAL 
Attribute 


SHOW TERMINAL 
Display 


SET TERMINAL 
Attribute 


LFFILL 


VFILL= 


LFFILL 


WRAP 


WRAP= 


WRAP 


Examples 






>SH0U 

Function? TERMINAL 







TT13: C303.123 

CLI = DCL BUF = 
LINES = 66, . TERM = 
LOUER NOPRIV NOHOLII 
ECHO NOVFILL NOHHT 



C303il2] 

132. HFILL = 
LA36 OWNER = SELF 
NOSLAVE NOESC NOCRT 
NOFDX WRAP NORPA 



SPEED=(300.300) 
BRO NOABAUD 
NOHFF NOREMOTE 
NOEBC TYPEAHEAD 



This example displays all the attributes for the user's own 
terminal. The command is the equivalent of SHOW TERMINAL: TI : . 
These include the terminal number, the login UIC, the default 
UFD, plus all the attributes that can be set with SET TERMINAL. 
See Table 3-2 and the remaining examples. 



>SH0U 


TERMINALITTSo; 










TT56I 


117,100] 




E303»53 








CLI = DCL 


BUF = 


80. 


HFILL = 


= 




LINES = 24. 


TERM = 


VT100 


OWNER = 


■■■ SELF 




LOWER PRIV 


NOHOLD 


NOSLAVE 


NOESC 


CRT 




ECHO NOVFILL 


NOHHT 


NOFDX 


WRAP 


NORPA 



SPEED=(?600»9600) 
BRO NOABAUD 
NOHFF NOREMOTE 
NOEBC TYPEAHEAD 



This example displays all the attributes for another terminal 



>SH0 TERM/ESCAPE 



This example shows that no terminal on the system is currently 
set to handle escape sequences. 

>SH0W TERMINAL/LA36/DCL 

DCL=TT5J 

LA36=C00J 

LA36=TT0J 

I..A36 = TT34S 

This example displays all the terminals on the system set as 
LA36s and all terminals on the system set to DCL. Note that the 
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order of the display is not necessarily the same as the order the 
attributes were listed in. Note also that the effect is the same 
as a SHOW TERMINAL/LA36 followed by a SHOW TERMINAL/DCL. In 
other words, the display does not show all LA36s set to DCL. 



>SH0 TERM/LQWERCASE 

LOWER=TTlt 

L0WER=TT3I 



>SH0 TERM/NOUPPERCASE 
L0WER=TT1J 



>5H0 TERM/NQLOWERCASE 

N0LQWER=TT2J 

N0L0WER=TT5i 



>SHG TERM/UPPERCASE 
N0L0WER=TT2: 



>SHQ TERM/HOLD_SCREEN 
H0LD=TT21 J 



>SH0 TERH/NOHOLD-SCREEN 

NOHOLD=TTi: 

NOH0LD=TT2! 



>SH0 1'ERM/MCR 
MCR=TT14: 
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>SHO TERM/DCL 
DCL=TT20: 



>SHO TERM/PRIVILEGED 
PRIV=TT7: 



>SH0 TERM/NOPRIUILEGED 
N0PRIV=TT10t 



>SHO TERM/SPEED 
SPEED=TT10J9600:9600 

This example displays the speed settings for the terminal from 
which the command was issued. 

Note that the transmission and reception rates are separated by a 

COlOn in t-hl S rllSnlau Khon imn = *-«= era >- «- i m-. J-K-..-.„ _.,;-_„ s.; 

- - - i; 1 - - "- — •-• jv« ^.t. ._ u^v-biuy v-iiOOC * O i..<r & f LUC 

figures are separated by a comma and enclosed in parentheses. 

>SHO TERM/ASR33 
ASR33=TT22J 

This example displays all the terminals on the system that are 
set to type ASR33. All the SHOW TERMINAL keywords naming 
specific models give the same kind of display. 

If you use the NO option, the display lists NOASR33=TTn: . 

>SH0 TERM/HARDCOPY 
N0CRT-TT1?: 



>BH0 TERM/NOHARDCOPY 
CRT=TT2i: 
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>SHQ TERM/SCOPE 
CRT=TT211 



>SHO TERM/NOSCOPE 
NOCRT=TT17: 

CRT means cathode ray tube, another name for a video screen or 
scope. 

>SHO TERM/CRFILL 
HFILL=TT10:0 

This example returns the /CRFILL value for the terminal from 
which it was issued. 



>SH0 TERM/LFFILL 
vFILL=TT42{ 



This example shows which terminal has its /LFFILL attribute 
enabled. 



>SHO TERM/FORMFEED 
FQRMFEED=TT13t 



>SH0 TERM/NOFORMFEED 
N0F0RMFEED=TT15t 

This example shows which terminals have their FORMFEED attribute 
enabled (or not) . 

>SHO TERM/TAB 
HHT=TT12t 



>SHO TERM/NOT AB 
N0HHT = TT7*. 

This example shows which terminals have their TAB attribute 
enabled. HHT means Horizontal Hardware Tabs. 
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>SH0 TERM/PAGE_LENGTH 
LINES=TT7I24 

This example displays the page size (screen size) of the terminal 
from which the command was issued. A nonprivileged user cannot 
display the page size of another terminal with this command. Use 
the unadorned SHOW TERMINAL. 



>SHO TERM/ECHO 
ECHO=TTi: 



>SHO TERM/NOECHO 
N0ECHD=TT15t 

>SH0 TERM/ESCAPE 
ESCSEQ=TTllt 



>SH0 TERM/NOESCAPE 
NOESCSEQ=TTi: 



ESCSEQ means ESCape SEQuences, 

>SHO TERM/FULL_BUPLEX 
FDX=TT2J 



:>3H0 TERM/NOFULL-DUPLEX 
N0FDX=TT1 t 



FDX means full-duplex, 

>SHO TERM/PASSALL 
RPA=TTi: 



>SHO TERM/INTERACTIVE 
N0RPA=TT3t 
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>SHO TERM/NOPASSALL 
N0RPA=TT3J 



>SH0 TERM/NOINTERACTIVE 
RPA=TTlt 



RPA means Read-Pass-All, 



>SH0 TERM/REMOTE 
REMOTE=TTl X 



>SH0 TERH/LOCAL 
N0REM0TE=TT12t 



>SH0 TERH/NOLOCAL 
REMQTE=TT1J 



>SHO TERH/NOREMOTE 
N0REM0TE=TT12: 



This attribute has nothing to do with the LOCAL/REMOTE switch 
found on some terminals. Remote terminals access the system 
through dial-up lines while local terminals are hard-wired to the 
computer. This attribute has nothing to do with DECnet host 
terminals either. 

The LOCAL/REMOTE switch on a terminal sets a terminal as a 
typewriter or terminal, respectively. 

>cun fERM/SLAME 
SLAVE=TT5A: 



>SH0 TERH/NOSLAVE 
NOSLAVE=TTit 
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>SHO TERM/TYPEAHEAB 
TYPEAHEAD=TT1J 



>SH0 TERM/NOTYPEAHEAD 
N0TYPEAHEAD=TT27J 



•-. r> I ir\ -r i— r*. \m dinir. 

/anu icnn/wrvHr 
UIRAP = TT1I 



>SH0 TERM/NOWRAP 
N0WRAP=TT45: 



>SH0 TERM/NOEIQHT_BIT 
NOEBC=TTlt 



>SH0 TERM/EIGHT_BIT 
EBC=TT6: 

EBC means Eight-Bit Characters. DIGITAL software uses 7-bit 
ACSII. 
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4.1 FILES ON RSX-11M/M-PLUS SYSTEMS 

The commands in this chapter are used to create files, list them in 
directories, remove them from directories, print copies of them on 
your terminal or the line printer, and alter their contents in various 
ways. Some error messages from commands described in this chapter are 
documented in Appendix A of this manual. Other error messages are 
documented in the RMS documentation supplied with your system. 

All files are stored on volumes. These volumes are written on 
lagnetic media, which can be placed on various physical devices. Once 



magr 



the volume is mounted, you can access the files on the volume, 
more information about volumes and devices, see Chapter 5. 



For 



Within each volume, files are organized in directories. For the 
entire volume, there is a Master File Directory (MFD). The MFD is a 
file named [0,0] 000000. DIR. Files in the MFD are all User File 
Directories (UFDs) . The UFD files are named after the group and 
member numbers. Thus, UFD [200,1] is a file listed 
named [0,0] 200001. DIR. 



in the MFD and 



See Figure 4-1 for an illustration of the relationship between volume, 
MFD, and UFD. 





MFD 
[0.0] 































UFD 
[200,1] 




UFD 
[303,5] 


















































HIYA.MAC;1 




FLY.TXT;1 




IZZY.TXT;1 




OZY.TXT;1 




LOGIN.CMD;1 



Figure 4-1 File Organization on a Volume 
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4.1.1 File Ownership and Location 

When you log in to the system, you identify yourself with a User 

Identification Code (UIC) . You log in to your default device and UFD. 

The default UFD has the same group and member number as your UIC. 

Nonprivileged users can change their default UFD, but not their UIC. 

Privileged users can change both. The UIC identifies the user; the 
UFD identifies the directory where files are located. 

The default device is actually a volume mounted on a device. Most 
file-handling commands are directed to the volume and not the device, 
but both volume and device are identified in the same format, ddnn:, 
where dd is a 2-letter mnemonic for the device type and nn is the 
octal unit number of the device. The colon is a required terminator. 
Usually, the command description or function makes clear whether the 
command is directed to the physical device or to the volume. 

Regardless of its physical designation, your default device is always 
called SYO:. This is a logical assignment made each time you log in. 
Information on your default device is kept by ACNT, the Account File 
Maintenance Program (Sections 3.1.1 and 3.1.3), and read from there 
each time you log in. 

When you create a file, the system places the file name in a UFD along 
with a User Identification Code (UIC), indicating the ownership of the 
file. Both the UFD and the UIC have the same format, a 1- to 3-digit 
octal group number and a 1- to 3-digit octal member number separated 
by a comma and enclosed in brackets. These numbers range from 
through 377 octal. 



Directory entries in both MFDs and UFDs consist of the names of files 
and pointers to file headers. The file header holds information about 
the file's owner and the location of the file on the mass-storage 
medium. Thus, a full file specification not only identifies the file, 
but locates it as well. 



4.1.2 File Specification 

File specifications, often called filespecs, are required for many DCL 
commands. 

The format of a file specification is as follows: 

ddnn: [g ,m] name.typ;ver 
ddnn: 

Specifies the type of device and unit number on which the volume 

containing the file is mounted. It consists of a 2-letter device 

name followed by an optional 1- or 2-digit octal unit number 
terminated with a colon. 

The 2-letter names for devices found on RSX-11M/M-PLUS are listed 
in Section 5.1. 



[g,m] 



Specifies the UFD. g and m are octal numbers from 1 through 377. 

g is the number of your group and m is your member number. You 

usually have full access to the UFDs with the same group number 
as yours. 
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Specifies the name of the file, an alphanumeric string from zero 
through nine characters long. 



,typ 



Specifies the file type. This field is a 0- through 
3-alphanumeric-character string that usually indicates the file 
contents. For example, .FTN is the file type for FORTRAN source 
programs. 

Always separate the name from the file type with a period (.). 

There are no restrictions on file types, but many system tasks 
use default file types for input and output files. These 
defaults and some system conventions on file types are summarized 
in Section 4.1.3. Null file types (0 length) are acceptable. 

;ver 

Specifies the version number, normally an octal number from 1 
through 77777. The version number identifies different versions 
of the same file. When you create a file without specifying a 
version number, the system assigns the file version number 1. 
Each time you create a new version of the file, by editing it, 
for instance, the system adds one to the version number. 

You must separate the file type and version number with a 
semicolon. 

You can also create a file with an explicit version number. 

If you create a file with version number 77777, you can be sure 
that file cannot be inadvertently superseded by a file with a 
higher number; 77777 is the highest possible version number. 
This is useful where you must have a particular version of a file 
for some operation. 

In addition, you can name version or version -1 in commands. 
Version defaults to the most recent version of the named file; 
version -1 defaults to the oldest version of the named file. 

In most cases, RSX-11M/M-PLUS systems do not require you to enter the 
full file specification. Defaults are supplied for all fields of the 
file specification except the name (see Section 4.1.3). In addition, 
you can use wildcards to specify groups of related files (see Section 
4.1.4) . 



4.1.3 Defaults in File Specifications 

Except for the file name, if you omit a field of the file 
specification, the system automatically supplies the field as 
specified here: 

Field Default 

ddnn: Your default device is established when you log in. SYO: 
is always your default device. Logging in assigns SYO: to 
some physical device. You can use SET DEFAULT to change the 
assignment of SYO:; you can display the assignment with 
SHwrt DEFAuui. ^ See Sec u i on 4 * _* . / Rememoer una u you do no u 
have to use the unit number for devices numbered 0. DB: is 
the same as DBO:, for instance. 
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Field Default 

[g,m] Your default UFD is established when you log in. The 
default is the UFD that has the same group and member 
numbers as your UIC. You can change the default UFD with 
SET DEFAULT; you can display the default UFD with SHOW 
DEFAULT. (See Section 4.5.) 

• typ Standard file types (see Table 4-1) are used as defaults. 
There is not a default file type in every situation. 

;ver For input files, the default is the highest numbered 
version; for output files, it is the next higher version 
number, or 1 if no previous version exists. 

The defaults make it possible for you to specify files without having 
to type in the full file specification. 

Suppose, for example, you log in with the UIC [200,20]. Your default 
device is DBO:, as recorded the System Account File, and assigned the 
name SYO:, and your default UFD is [200,20]. Assume further that 
there are three sequentially numbered versions of a file called 
TEXT. TXT in the directory. If you wish to print the highest numbered 
version of this file (version 3) on your terminal, all of the 
following forms of the TYPE command produce the same desired result: 

>TYPE TEXT. TXT 

>TYPE TEXT. TXT ) 3 

>TYPE TEXT.TXTJ0 

>TYPE C200 f 20DTEXT.TXTJ3 

>TYPE DBO {TEXT. TXT 

>TYPE DBOi L200720HTEXT.TX I 

>TYPE SYSTEXT.TXT 

>TYPE SY I C 200 , 20 1 TEXT . TXT i 3 

>TYF'E SY; L 200 » 20 J ILXI . 1X1 JO 

In most cases, you will use the first form, but if you wish to keep a 
permanent record of the terminal session, you may choose one of the 
more explicit forms. In any case, the system uses the final form 
given, as that form has all the defaults supplied. (Note that version 
will not always be version 3, but is the highest numbered version, 
which is number 3 by definition in this example.) 

Table 4-1 
File Types 



File Type Use 



• BAS BASIC-11 source program. System default, 



.RAT 



,BLD 



File containing batch processing commands. System 
convention. ■ ... ■ . . ' '■'■'"■■■ : ■■ ■ : J/"":' .'"■■■.■>,." ' 

Indirect command file used by the SYSGEN procedure 
to create files needed to build system tasks. 
System default. 



•B2S BASIC-PLUS-2 source program. System default. 
■CBL COBOL source program. System default. 

(Continued on next page) 
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Table 4-1 (Cont.) 
File Types 



File Type Use 



.CMD Indirect command file. System default. 

•COR SLP file used to correct a source file. System 
convention. 

•DAT File containing data, as opposed to code. System 
default . 

.DIR File is either Master File Directory or User File 
Directory. System default. 

•DMP Dump file created by File Dump Utility. System 
default. 

•FTN FORTRAN-IV, FORTRAN-IV-PLUS, or FORTRAN-77 source 
program. System default. 

•LOG Log of batch processing session. System default. 

•LST Listing file. System default. 

•MAC MACRO-11 source program. System default. 

•MAP Task Builder map file. System default. 

•MLB Macro library. System default. 

•OBJ Object module output from assembler or compiler. 
System default. 

• ODL File containing Overlay Descriptor Language to be 
used by Task Builder. System default. 

•OLB Object module library. System default. 

♦PAT Correction file used by assembler to create patched 
object module. Must be specified. 



Patched object module input for PAT utility; must 
be specified. See Chapter 14 of the RSX-11M/M-PLUS 
Utilities Manual for more information on file types 
.PAT and .POB. 

File containing Postmortem Dump of interrupted task. 
System default. See the RSX-11M/M-PLUS Task Builder 
Manual for more information. 



•SML File containing system macro library. Other macro 
libraries have the type .MLB. System default, but 
must be specified on input file. 



Symbol definition file created by Task Builder. 
System default. See Section 6.4 and the 
RSX-11M/M-PLUS Task Builder Manual for more 
information. 

(Continued on next page) 
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Table 4-1 (Cont.) 
File Types 



File Type Use 



,SYS A bootable system image. System default, 

,TMP A temporary file. System convention. 

,TSK Task image file. System default. 

,TXT A text file. System convention. 

.ULB Universal library. System default. 



4.1.4 Wildcards in File Specifications 

In addition to the regular defaults for the current device, the 
current UFD, and the most recent version, you can use wildcards with 
the commands in this chapter to set up temporary defaults for every 
part of the filespec except the device name. 

Simple wildcarding uses the asterisk (*) to replace all or any field 
in the filespec. 

For instance, the command 

>Ii I RECTORY [303,*.] 

lists all files on the default volume with the group number 303, 
regardless of member number, and 

^DIRECTORY II * » 5 J 

lists all files on the default volume with member number 5, regardless 
of group number. 

The command 

> DIRECTORY C* , * DTEXT . TXT 

lists the most recent versions of all files on the default volume 
named TEXT. TXT, regardless of the group or member number. 

Likewise, the * in place of the version number means "all versions". 

The command 

>U I RECTORY UOM.BAT?* 

lists all versions of the file WOM.BAT on the default volume and in 
the default UFD. 

The * can also be used to replace an entire file name or file type in 
much the same way. 

The command 

>DIRECT0RY *,BAT 

lists the most recent versions of all files with the type .BAT and any 
name on the default volume and in the default UFD. 
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The command 

>H I RECTORY COririON.a 

lists the most recent versions of all files with the name COMMON 
any type on the default volume and in the default UFD. 



and 



The examples thus far have demonstrated the simple form of 
wildcarding, using the * to replace an entire field in a filespec. 
Simple wildcarding works with all the commands in this chapter. The 
PRINT command accepts simple wildcarding, as does the SUBMIT command 
for RSX-11M-PLUS batch processing. Many utilities also accept simple 
wildcarding. See the RSX-11M/M-PLUS Utilities Manual for information 
on how each utility handles wildcards. 

Most of the commands in this chapter work through PIP, the Peripheral 
Interchange Program. For the PIP-related commands, DIRECTORY, DELETE, 
PURGE, COPY, RENAME, TYPE, APPEND, UNLOCK, and SET PROTECTION, a more 
elaborate form of wildcarding is available. In these commands, within 
file names and file types, the * can be used in a more complex manner. 
The * actually means "match zero or all characters in this position." 

Therefore, the command 

> DIRECTORY L*.TXT 



lists the most recent versions of all files with the type ,TXT 
names start with L on the default volume and in the default UFD. 

And the command 



whose 



^DIRECTORY *L*.TXT 

lists the most recent versions of all files with the type .TXT whose 
names include an L on the default volume and in the default UFD. 

The same substitutions can also be used in file types, so that the 
command 

^DIRECTORY SNOBLO.L* 

lists the most recent versions of all files with the name SNOBLO and 
the type beginning with an L on the default volume and in the default 
UFD. 

You can use more than one wildcard in file names and file types. 
The command 

^DIRECTORY *F*D*.TXT 

lists the most recent versions of all files with the type .TXT whose 
names include an F and a D in that order. 

In addition, the PIP-related commands permit the percent sign (%) to 
be used as a wildcard, but only within file names and file types. The 
% means "match exactly one character in this position." 

The following command, for instance 

DIRECTORY "/..TXT 

lists all files with the type .TXT and a single-character file name on 
the default volume in the default UFD. 
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The command 

>DIRECTORY N U % " 3 1. -TXT 

lists all files with the type .TXT and a file name consisting of NOV 
and 81 separated by two characters on the default volume in the 
default UFD. 

The wildcards can be combined in a single filespec. 

The command 

^DIRECTORY %L*T,TM% 

lists all files whose names begin with a single character followed by 
an L and end with a T and with a file type consisting of .TM and 

Wildcarding, combined with systematic policies of UFD assignments, 
file names, and file types can add considerable flexibility and 
convenience to your use of the system. 

In addition, the PIP-related commands, DIRECTORY, DELETE, PURGE, COPY, 
RENAME, TYPE, APPEND, UNLOCK, and SET PROTECTION also accept several 
other qualifiers that add further flexibility to these commands. 

First, there are the date-oriented qualifiers: 

/DATE : dd-mmm-yy 

/SlNCE:dd-mmm-yy 

/THROUGH: dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH: dd-mmm-yy 

/TODAY 

These qualifiers all depend on the creation date of the file as shown 
in the DIRECTORY listing. /DATE limits the operation of the command 
to files created on the specified date. /SINCE limits the operation 
of the command to files created on or after the specified date. 
/THROUGH limits the operation of the command to files created before 
or on the specified date. /SINCE and /THROUGH can be combined to 
limit the operation of the command to files created within a given 
range of dates. /TODAY limits the operation of the command to files 
created on the same day the command was issued. 

You can enter the date in either of two forms: 

dd-mmm-yy as in 25-DEC-82 
or 

mm/dd/yy as in 12/25/82 
The system always displays dates in the first form. 
The PIP-related commands also accept the following qualifier: 

/EXCLUDE:filespec 

The /EXCLUDE qualifier allows you to exclude a file or files from the 

operation of the command. The filespec argument to /EXCLUDE must 

include a version number, but the version number can be *. Wildcards 

are accepted for all parts of the filespec argument to /EXCLUDE. 
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4.1.5 File Protection and Volume Protection 

Data privacy and system security are provided by restrictions on 
access to volumes and the files on the volumes through volume 
protection and file protection. Volume protection refers to access to 
a mounted volume. You must have access rights to the volume before 
you can have access to any file on the volume. This access is 
determined through a protection code. 

Once you have access to the volume, you must then have access to the 
file. File access is also determined through a protection code. The 
volume protection code and file protection code are slightly different 
because their functions are slightly different. The differences are 
noted in the following description. 

Each file has a protection code, which specifies whether different 
kinds of system users who may access to the file, and what they may do 
to the file when they access it. 

There are four kinds of users: 

SYSTEM The operating system itself, and privileged users, those 
having group numbers of 10 or less. 

OWNER The user having the same UIC as that the file was 
created under. 

GROUP All users having the same group number as that the file 
was created under. 

WORLD All other users. 

There are also four kinds of access to files: 



READ 



The user, or the user's tasks, may read, copy, print, or 
type the file, and if it is a task, run it. 



WRITE The user, or the user's tasks, may add new data to the 
file by writing to it. 

EXTEND The user, or the user's tasks, may change the amount of 
disk space allocated to the file. 

DELETE The user, or the user's tasks, may delete the file. 

These forms of protection are expressed with a single character for 
each. The default protection applied to all files on the system that 
have not been otherwise protected is: 

SYSTEM : RWED , OWNER : RWED , GROUP : RWED , WORLD : R 

See also the discussion of directory protection in Section 4.2.2. 

Volume protection codes differ from file protection codes in that 
EXTEND protection is called CREATE protection. The function of the 
code is the same. Either EXTEND protection or CREATE protection 
refers to the right to allocate space on a volume. CREATE under 
volume protection refers to your ability to allocate space for a new 
file, while EXTEND under file protection refers to your ability to 
allocate space within an existing file. 

The default protection applied to all volumes on the system that have 
not been otherwise protected is: 

SYSTEM: RWCD , OWNER : RWCD , GROUP : RWCD , WORLD : R 
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In fact, you can use a C in a file protection code or an E in a volume 
protection code and the command will be accepted, but it is good 
practice to use the correct protection category. 



4.2 CREATING DIRECTORIES AND SEQUENTIAL FILES 

The CREATE command without a qualifier enables you to create a 
sequential file directly at your terminal. The CREATE/DIRECTORY 
command permits a privileged user to create a User File Directory 
(UFD) . 



4.2.1 CREATE 

CREATE creates a sequential file and enables you to type text directly 
into the file from your terminal without using an editor. 

Format 

CREATE 

File? filespec 

CREATE filespec 

Parameter 

filespec 

Specifies the name of the file to be created. 

As soon as the command is entered, the cursor (or print head) 
moves down a line. The file is open for input. Any text you 
type goes into the file. 

When you have finished entering text, type a CTRL/Z to close the 
file. 

If you wish to create an empty sequential file, simply enter the 
CTRL/Z first. See examples. 



Examples 



>CREATE (E) 

File? COPY.CMD © 

» Command file to move files from Hank's UFD to my UFD EED 

.enable: substitution (ED 
.loop: 11 

, ASKS FI Whet, file: (E) 

COPY DB2:c;'503?26 I'Fl ' -J" dB 

.GOTO LOOP (RED 

(CTRL? 
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In this example, the user wanted to move a number of files from 
one directory to another. With CREATE, the user created an 
indirect command file at the terminal. After entering the CREATE 
command and filespec, the cursor (or print head) moves to the 
left margin. The terminal is attached for input to CREATE. Note 
that_ while CREATE is executing, the RETURN key acts only as a 
carriage return, and not as a means of entering commands to the 
system. No commands are accepted by DCL until after the CTRL/Z 
(echoed as *Z) . 

>CREATE JOE. TXT (ED 

Joe called at 4J30 on Monday* He'll be back from Switzerland on (ED 

Thursday? but he won't be in the office until Friday afternoon. fffRUz) 

In this example, the user used CREATE to take notes on a phone 
call. 

>CREATE CHURCKYLA.FEM (ED 

grfiUzj 

In this example, the user used CREATE to create an empty file for 
later use. 



Notes 



CREATE differs slightly in batch jobs. See the RSX-11M/M-PLUS 
Batch and Queue Operations Manual for further information. 

If you create a file without specifying a version number and no 
file of that name and type exists, the file is version 1. If a 
file of that name and type exists and you give no version number, 
the new file has a version number one higher than the highest 
numbered previous version. 

If you specify a version number when creating the file, the 
system creates a file with the version number you give. If there 
is already a file with the same name, type, and version number, 
that file is deleted and replaced by the file you created. 

If you use CTRL/U when creating a sequential file, the text on 
the line is eliminated, but not the line itself. In other words, 
CTRL/U leaves a blank line behind when it deletes a line. 
CTRL/U, CTRL/R, and the DELETE key are the only editing 
facilities available to you when creating sequential files at the 



4.2.2 CREATE/DIRECTORY 

CREATE/DIRECTORY creates a User File Directory (UFD) on a Files-11 
volume and enters the UFD into the volume's Master File Directory 
(MFD) . 
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Privileged users can create UFDs on volumes mounted on any device. 
Nonprivileged users can create UFDs only on volumes mounted on their 
own private (allocated) devices. 

Format 

CREATE/DIRECTORY[/qualifier [s] ] 
Device, UFD? [ddnn:] [ [g,m] ] 

CREATE/DIRECTORY [/qual if ier [s] ] [ddnn:] [ [g,m] ] 
Command Qualifiers 

/ALLOCATION :n 
/PROTECTION: code 
/LABEL : volumelabel 

Parameters 

[ddnn:] [[g,m] ] 

You must specify at least one of these parameters. If you 
specify one parameter, the default volume or UFD is used for the 
other parameter. You cannot create a directory that matches both 
your default device and your default UFD. 



ddnn: 



CnD^ifioc M-.o ^owiro rtry ulhirh fhs imllimo VR11 Wish to Crpahfi the 
w^^^- ^. ^^~ ~ ~« , ■ -- . ~ u ~— ■ - - 

directory is mounted. This parameter defaults to SYO:. 
The volume must be a mounted, Files-11 volume. 



[g»m] 

Specifies the group and member numbers of the directory you wish 
to create. This parameter defaults to the current UFD. 

Command Qualifiers 

/ALLOCATIONS 

Specifies the number of directory entries (file names) for which 
space is to be allocated, n is rounded up to the next multiple 
of 32. 

The default is /ALLOCATION: 32 . 

/PROTECTION: (code) 

Specifies the protection code for the directory file, not for 
files in the directory. Since the directory is a file, READ 
access is the right to list the directory, and WRITE access is 
the right to create files in the directory. If you do not have 
EXTEND access to a directory, you may be denied the right to 
create more than a certain number of files in the directory. 
DELETE access means the right, to delete the directory file. If 
you delete a directory file, you must use the VFY utility to 
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recover files from the directory. See Chapter 9 of the 
RSX-11M/M-PLUS Utilities Manual . 

The default is the protection code the disk was mounted with. 
The default for mount protection is the protection code the 
volume was initialized with. 

The default system protection code is: 

/PROTECT ION : (SYSTEM : RWED , OWNER : RWED , GROUP : RWED , WORLD : R) 

See also Sections 4.1.5 for more information on file and volume 
protection. 

/LABEL : volumelabel 

Specifies that the volume label that you supply be compared with 
the label on the volume. If the names match, a UPD can be 
allocated. If they do not match, the command is rejected. 

If you do not specify this qualifier, the volume label is not 
checked . 

Examples 

>CREATE/DIRECTQRY 
Device* UFD? DB2: C303 * 5 3 

This example creates UFD [303,5] on the volume mounted on device 
DB2:. Nonprivileged users can create directories only on volumes 
mounted on a device they have allocated. Privileged users can 
create directories on volumes mounted on any device. 

>CREATE/D I RECTORY DB2 1 1: 303 * 5 3 
This example is identical to the previous one. 

>CREATE/DIRECTORY 
Device* UFD? [222*2223 

This example creates UFD [222,222] on the default device. 

>CREATE/DIRECTORY 
Device* UFD'? DBA; 

This example creates a directory on the volume mounted on DB6: 
with the same group and member number as the default UFD. 

>CREATE/D I RECTORY /PRO rfc.i.;( ION J C S Y8 J RWED . OWN : R > 6R0 I R , WORLD t R ) 
Device* UFD'? DR2 ', C 100 * 100 J 

This example creates UFD [100,100] on the volume mounted on 
device DR2 : . The protection code is the protection code applied 
to the actual file containing the directory, DR2: [0 ,0] 100100 .DIR. 
The code in this example permits privileged users to perform all 



4-13 



HANDLING FILES 



EDIT/EDT 



operations on this file: READ (list the directory) , WRITE (add 
files to the directory)/, EXTEND (alter the size of the directory 
file) , and DELETE (delete the directory file) . All other users 
can READ (list) the directory only. This protection mask has no 
relationship to the protection applied to files in the directory, 
or to volume protection, both of which may differ from the 
protection applied to the directory file. See Section 4.1.5. 



4.2.3 EDIT 

EDIT or EDIT[/EDT] invokes EDT, the DEC standard editor. 

EDIT/SLP invokes the Source Language Input Program, a program 

maintenance utility. EDIT/EDI invokes EDI, the Line Text Editor. 

EDIT also invokes KED and K52, if present, and any unsupported editors 
you may have in your installation. The default is EDIT[/EDT] . 



4.2.3.1 EDIT [/EDT] 

EDIT invokes EDT, the DEC standard Editor. See the EDT Editor Manual 
for more information. 



Format 



EDITr/EDTl [/qualifier [sH infile 

or 
EDIT [/qualifier [s] ] infile 

Command Qualifiers 

/ [ NO] COMMAND [ : f i lespec ] 
/[NO] JOURNAL [ :f ilespec] 
/ [NO] OUTPUT [ : f ilespec] 
/[NO]READ_ONLY 
/[NO] RECOVER 

Parameter 

infile 

Specifies the file to be edited. If the file does not exist, EDT 
creates it. 

You must supply a file name, but the type can be null. 

Command Qualifiers 

/[NO] COMMAND [ :f ilespec] 

Controls whether an EDT initialization file is read by EDT before 
editing begins. These files contain commands that alter the 
default setup for EDT, such as custom line-mode commands and 
change-mode key definitions. 

The default is /COMMAND: EOTINI [ .EDT] . 
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If you use this qualifier and EDTINI.EDT or some other file you 
name does not exist, EDT issues no error message and continues 
with the editing session. 

If you have a file EDTINI.EDT and do not wish to use it, use the 
/NOCOMMAND qualifier. 

/ [NO] JOURNAL [ : f i lespec] 

Controls whether EDT creates a journal file for the editing 

session. The default is to create a journal file with a file 

name the same as that of the input file with the type .JOU. You 

can specify a different name by including a filespec. 

The journal file consists of all editing commands and text 
entered during the session. If the editing session ends 
abnormally, such as through a system crash, or your inadvertently 
typing three CTRL/Zs in succession, the journal file is saved. 
In such a case, you invoke EDT again, with the same command line 
as before plus the /RECOVER qualifier. Your editing session is 
repeated and all your editing is restored. If the editing 
session ends normally, the journal file is deleted. 

If you specify /NOJOURNAL, no journal file is created and no 
recovery is possible. 

/ [NO] OUTPUT [ : fi lespec] 

If you do not specify this qualifier, the default is to create a 
file of the same name and type as the input file with a version 
number one higher than the input file. If the file is new, EDT 
creates version number 1. You can alter the name of the output 
file by including a filespec with the /OUTPUT qualifier. 
Otherwise, the qualifier need not be included. 

If you specify /NOOUTPUT, you cannot exit EDT without including a 
filespec in your EDT EXIT command. 

/[NO]READ_ONLY 

Specifies whether you wish simply to read the file or to edit it. 
If your command line includes /READ_ONLY, you can use the full 
facilities of EDT, but you cannot exit without including a 
filespec in your EDT EXIT command. Normally, you would use the 
EDT QUIT command if you had specified /READ_ONLY. The /READ_ONLY 
qualifier is equivalent to a combination of /NOOUTPUT - and 
/NOJOURNAL. You can use /READ_ONLY to look at files to which you 
have no write access. 

The default is /NOREAD_ONLY, which need never be specified. 
/[NO] RECOVER 

Specifies whether EDT reads commands from a journal file prior to 
starting the editing session. With a journal file, your editing 
session can be restored if interrupted by a system crash or other 
problem. The default is /NORECOVER, which need never be 
specified . 



4-15 



HANDLING FILES 



EDIT/EDT (Cont.) 



The /RECOVER qualifier requests EDT to open the input file and 
then read EDT commands and text from the file with the same file 
name as the input file and the file type .JOU. The command line 
with /RECOVER added to it must be identical to the command line 
that initiated the original failed editing session. This means 
that if you specified an EDT initialization file, you must 
specify the same file in the /RECOVER command line. And, if you 
specified a name for the journal file other than infile.JOU, you 
must include the /JOURNAL qualifier with the appropriate 
filespec. If journaling was not enabled on the original command 
line, you cannot recover the editing session. 



Examples 



>EDIT 

File? HORNBLOW.TXT 

Input file does not exist 

CE0B3 

* 

This example shows the EDIT command in its simplest form. The 
file HORNBLOW.TXT is created during the editing session. 



>EDIT HORNBLOW.TXT 

This is the one-line form of the same command. 

>EDIT/OUTPUTiUMPIRE.MAC WEAVER, MAC 

1 .TITLE WEAVER 

* 

In this example, the user takes an existing file as input and 
edits it to create a new file. 



>ED I T /COMMAND t FORMAT RAMBLE . RNO 
Input file does not exist 
CE0B3 

* 

In this example, the user prepared an EDT initialization file 
called FORMAT. EDT. This file contains EDT command definitions 
designed to be used with a text formatting program. See next 
example. 

>ED I T/COMM ANDt FORM AT /RECOVER S AMBLE. RNO 

! This is FORMAT. EDT. Version 2.4 Ambrose Biercei Maintsiner 



During the editing session started in the previous example, the 
system crashed. Once it was back on the air, the user duplicated 
his original command exactly, naming the same EDT initialization 
file and then added the /RECOVER qualifier. EDT begins 
reproducing the entire editing session, beginning with reading in 
the initialization file, the first line of which is seen in the 
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example. All the editing commands and text entered during the 

session have been recorded in the file RAMBLE. JOU, which is also 

read back in by EDT. The result is that the entire editing 

session is repeated up to within a few keystrokes of the crash. 

If you wish to test the recovery procedure, start editing a file 
and then enter three CTRL/Zs as line-mode commands. This causes 
an unnatural exit from EDT, so the journal file is saved. You 
can then duplicate the original command line, add the /RECOVER 
qualifier, and watch yourself edit. 



Notes 



See the EDT Editor Manual for more information on journaling, 
initialization files, command and key definitions, and the other 
editing functions of EDT. 

The qualifiers used with EDIT/EDT will not work with other forms 
of the EDIT command. If you use the /EDT qualifier, it must 
appear immediately after EDIT on the command line. Other 
qualifiers can float. 

You can use the MCR command to invoke EDT in a different format 
that some users may find more convenient. See the EDT Editor 
Manual for the alternate command format. 



4.2.3.2 EDIT/SLP 

EDIT/SLP invokes the Source Language Input Program (SLP) , an editor 
designed for maintaining and updating source files. SLP enables you 
to delete, replace, or add lines to an existing file or create source 
files. SLP also has an optional audit trail which enables you to keep 
track of changes in the file. See Chapter 13 of the RSX-11M/M-PLUS 
Utilities Manual for more information on SLP. 

Format 

EDIT/SLP[/qualifier[s] ] infile 
Command Qualifiers 

/[NO] AUDIT [:arg] 

POSITlON:n 

SIZE:n 
/ [ NO] CHECKSUM [ : arg ] 
/[NO]LIST[:filespec] 
/ [NO] OUTPUT [ : f ilespec] 
/[NO] REPORT 
/[NO] TAB 
/[NO] TRUNCATE [:n] 
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Parameter 

inf ile 

The input file is the source program to be updated by SLP. 

Qualifiers 

/[NO] AUDIT[: (arg[s] ) ] 

POSITION:n 
SIZErn 

Controls whether the output file includes an audit trail, and 

optionally allows you to specify the location and size of the 

audit trail. You can specify one or both of these values. If 

you specify only one, you can omit the parentheses, but the 

parentheses are required syntax if you specify both POSITION and 
SIZE. Separate the two arguments within the parentheses by a 
comma ( , ) . 

The POSITION: argument sets the starting position of the audit 
trail. The value of n can be from through 132, representing 
the column at which the first character in the audit trail is to 
appear. This value is rounded up to the next highest tab stop. 
The default is to start the audit trail at column 80. Note that 
this default causes audit trails of more than a single character 
to wrap around when displayed on standard video terminals. 

The SIZE: argument sets the length of the audit trail. The 
value of n can be from through 14. The default is an audit 
trail of 8 characters. 

The audit trail itself is defined from within SLP. See Chapter 
13 of the RSX-11M/M-PLUS Utilities Manual . 

/[NO] CHECKSUM [:arg] 

Controls whether a checksum is calculated for the SLP commands. 
If you specify checksum without an argument, SLP calculates the 
checksum value and prints it on your terminal. If you specify an 
argument, SLP calculates the checksum and compares it to what you 
have specified. If the numbers differ, a warning message is 
displayed, but the execution of SLP is not interrupted. 

The default is /NOCHECKSUM. 

/ [NO] LIST [ : f ilespec] 

The /LIST qualifier creates a listing of a file with line 
numbers. If you do not give a filespec, the default filespec is 
f ilename.LST. 

The default is /LIST. /NOLIST suppresses creation of the listing 
file. 
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/ [NO] OUTPUT [ : f ilespec] 

Use this qualifier to change the name of the output file. The 
default output filespec is the same name and type as the input 
file and a version number one higher than the highest existing 
version of the file. If you do not wish to override this 
default, you do not need this qualifier. 

The /NOOUTPUT qualifier suppresses the creation of an output 
file. 

/[NO] REPORT 

Controls whether line truncations that result from audit trails 
are reported. If you specify /REPORT, you receive warning 
messages on your terminal and the affected lines are marked with 
a question mark (?) in place of the period (.) in the line number 
in the listing file. 

The default is /NOREPORT. 

/[NO] TAB 

Controls whether SLP replaces tabs or spaces at the end of each 
record containing an audit trail. If you specify /TAB, tabs are 
inserted. If you specify /NOTAB, spaces are inserted. The 
default is /NOTAB. 

/[NO] TRUNCATE [:arg] 

The TRUNCATE qualifier requests SLP to truncate each record in 
the input file when it creates the output file. This qualifier 
allows you to delete an audit trail from a file previously 
updated with SLP. If you specify /TRUNCATE without a number, SLP 
truncates input records at the beginning position of the audit 
trail. If you specify a number, SLP truncates the records 
beginning at the column. The value of n can be from through 
132. 

The default is /NOTRUNCATE. 

Notes 

You must understand how to use SLP to use this command. See 
Chapter 13 of the RSX-11M/M-PLUS Utilities Manual for more 
information. 

The qualifiers used with EDIT/SLP will not work with other forms 
of the EDIT command. The SLP qualifier must appear immediately 
after EDIT on the command line, but other qualifiers can float. 

From MCR, you can invoke SLP in a different format that some may 
find more convenient. See the Utilities Manual for the alternate 
command format. 
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4.2.3.3 EDIT/EDI and EDIT/editor 

EDIT/EDI invokes EDI, the Line Text Editor. The EDIT command can also 
be used to invoke KED and K52, which are supported but not bundled 
with RSX-11M/M-PLUS systems as well as various unsupported editors. 

Format 

EDIT[/qualif ier] [edit-input] 

Command Qualifiers 

/EDI 

/USING:yyy 

/SOS 

/TECO 

/MAKE 

/MUNG 

/KED 

/K52 

/OUTPUT: filespec 

/CREATE 

/[NO]READ_ONLY 

Parameter 

edit-input 

Any valid input to the chosen editor may be supplied here. 
Usually this will be a file specification, but anything, 
including a carriage return, that is valid for the chosen editor 
is a proper parameter for this command. 

Command Qualifiers 

Only one qualifier can be specified. This qualifier identifies 
the editor or function you wish to access. 



/EDI 



Specifies EDI, the Line Text Editor, an interactive, 
line-oriented editor used to create and maintain text and source 
files. See Chapter 2 of the RSX-11M/M-PLUS Utilities Manual for 
more information on EDI. 

/USlNG:yyy 

Specifies that an editor not supplied by DIGITAL is being used, 
where yyy is the installed name of the editor. 

/SOS 

Specifies the unsupported editor, Son of Stopgap. 
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/TECO 
/MAKE 
/MUNG 



Specifies functions of the unsupported editor, Text Editor and 
Corrector. 



/KED 
/K52 



The /KED qualifier invokes KED, the Keypad Editor, which is part 
of the Forms Management System (FMS-11) software. FMS-11 is not 
bundled with RSX-11M/M-PLUS systems. The /K52 qualifier invokes 
a version of KED for VT52 terminals. 

Other EDIT qualifiers for use with KED or K52 are /CREATE, 
/OUTPUT, and /[NO]READ_ONLY. 

/CREATE 

Use /CREATE with EDIT/KED or EDIT/K52 when you wish to edit a 
file that does not exist, 

/OUTPUTrf ilespec 

Use /OUTPUT with EDIT/KED or EDIT/K52. If you do not specify 
this qualifier, the default is to create a file of the same name 
and type as the input file with a version number one higher than 
the input file. You can alter the name of the output file by 
including a filespec with the /OUTPUT qualifier. Otherwise the 
qualifier is not needed. 

If you specify /NOOUTPUT, no output file is created when you exit 
KED. 

/[NO]READ_ONLY 

Specifies whether you wish simply to read the file or to edit it. 
If your EDIT/KED or EDIT/K52 command includes /READ_ONLY, you can 
use the editor, but you cannot create a new version of the file. 
/NOREAD_ONLY is the default and need not be specified. 



Examples 



>EDIT/EDI CHILI. MAC.2 
C00066 LINES READ IN3 
CPAGE 13 
*.. 



This example invokes EDI and names an existing input file. 
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>ED IT/SOS HARRY. MAC 5 5 
Edit: DUO J C 7 f 7 3 HARRY . MAC : 5 

This example invokes SOS for a file that already exists. 

>EDIT/SQS LONNN Y.MAC 

I riput ', DUO ; I 7 i 7 1 LONNN Y .MAC J 1 

00100 _ 

This example invokes SOS for a file that is being created. 
>EDIT/TEC0 PUNK.TST 

This example invokes TECO for a file that already exists. 

>EDIT/MAKE JUNK.TST 

This example invokes TECO for a file that does not exist. 

>EDIT/MUNG DOIT 

Output depends on file. 

This example invokes TECO where DOIT is a file of TECO commands. 

Notes 

There are no prompts from this form of the command. 

No checking of the edit-input parameter is performed by DCL. The 
editor does all the checking. 

The unsupported editors SOS and TECO are found on many 

RSX-11M/M-PLUS systems. Commands to access these editors are 

included only for the convenience of users. No support is 
implied . 



4.3 MAINTAINING A DIRECTORY 

The following commands provide you with the means for keeping your 
directory up to date. Disk space on mass storage devices is an 
important resource. You should not keep files that you do not need. 



4.3.1 DIRECTORY 

DIRECTORY displays information on files in directories. 
Format 

DIRECTORY [/format-qual] [/destination-qual] [filespec[s] 
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Command Qualifiers 

Format 

/FULL 

/BRIEF 

/FREE[ddnn:] 

/SUMMARY 

/ATTRIBUTES 

Destination 

/PRINTER 
/OUTPUT: filespec 

Other 

/DATE:dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH :dd-mmm-yy 

/S I NCE : dd-mmm-y y/THROUGH : dd -mmm-y y 

/TODAY 

/EXCLUDE: filespec 

Parameter 

f ilespec[s] 

Specifies the file or files for which information should be 
displayed. If you do not supply a filespec, a complete directory 
for the default UFD is displayed. 

You can supply one or more filespecs, separated by commas, and 
directory information on the files you name is displayed. 

You can use wildcards in place of any filespec field except the 
device field. If you do not supply a version number, only 
information on the most recent versions is displayed. However, 
if you do not supply a file type, a null file type is assumed. 
If you do not know the file type, use a wildcard. 

You can display a directory for another UFD by supplying the UFD 
in this field. You can also specify device names in the form 
ddnn: in this field. 

If you name files in two directories, you should name files for 
the default UFD first. If you name files from another device or 
directory first, the defaults are canceled. See examples. 

Command Qualifiers 

Command qualifiers are in three groups: 

1. Format qualifiers control the appearance of the directory. 

2. Destination qualifiers control where the command output is 
sent. 

3. Other qualifiers modify the list of files by creation date or 
exclusion. 
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If you do not supply a format qualifier, the display is in standard 
format, giving the file name, type, and version number, the number of 
blocks the file occupies, and the date and time of creation. 

If you do not include a destination qualifier, the display appears on 
your terminal. 

If you do not include any of the other qualifiers, the display 
includes all files that otherwise qualify. 

Format 

/BRIEF 



Specifies that the display give file names, types, and version 
numbers only. 



/FULL 



Specifies that the complete directory entry be displayed, 
including File ID number, blocks used and allocated, the owning 
UIC, protection status of the file, in addition to all the 
information in the standard display. 



/SUMMARY 



Specifies that the display give only the total number of blocks 

allocated and used for the specified files. If you give no 

f i. lesnens in the command- the distjlaw shows the total blocks 
allocated and used for the default directory. 



/FREE [ddnn:] 



Specifies that the display give the free space and number of free 
file headers on the default device or a specified device. 



/ATTRIBUTES 



Displays the Record Management Services (RMS-11) attributes of a 
file or files. This display includes file name and type, 
creation date and time, file organization, protection status, 
allocation information, last access date and time, record format, 
record size, primary and alternate key definitions for indexed 
files, and bucket size .for indexed and relative files. This 
qualifier invokes the RMS-11 DSP utility. Note that this display 
is produced for any file you specify in a DIRECTORY command, 
whether or not the file is an RMS-11 file. Some display 
information may not be meaningful for non-RMS files. See the 
RMS-11 documentation supplied with your system. 

Destination 

These qualifiers direct output to an output file or to the line 
printer. 

/OUTPUT: filespec 

Specifies that the output of the DIRECTORY command be placed in a 

file having the filespec you supply. 
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/PRINTER 

Specifies that the output of the DIRECTORY command be printed on 
your system's line printer. (RSX-11M-PLUS only.) 

Other 

/DATE:dd-mmm-yy 

The /DATE qualifier specifies that you wish the DIRECTORY command 
to list only files created on the date given. 

/SINCE:dd-mmm-yy 

The /SINCE qualifier specifies that you wish the DIRECTORY 
command to list only files created on or since the date given. 

/THROUGH : dd-mmm-yy 

The /THROUGH qualifier specifies that you wish the DIRECTORY 
command to list only files created on or before the date given. 

/SINCE :dd-mmm-yy/THROUGH: dd-mmm-yy 

The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the DIRECTORY command to list only files created 
within that range. 

/TODAY 

The /TODAY qualifier specifies that you wish the DIRECTORY 
command to list only files created on the same day the command is 
being issued. 

/EXCLUDE: filespec 

The /EXCLUDE qualifier specifies that you wish the DIRECTORY 
command not to list certain files. The filespec argument to 
/EXCLUDE can contain wildcards, but the version number must be 
given, either explicitly, or as "*" wildcard. 



Examples 



>DIRECTORY 

Directory DB1 : C303 > 5 1 
1-N0V-82 14 t 16 



A. Ail 

ANIML.BASJ1 

AZ.CMDJ5 

BYE.CMDS1 

CLEAN. ChD?l 

DUN.CMD.4 

EIiT.CMDi 22 

LQX.CMDS1 

LOGIN. CMBJ6 

TI.CMDJ4 



1 . 
6. 
1. 
1. 
1 , 
1 . 
1. 
1, 
1. 
1 , 



25- 


-SEP- 


-82 


12529 


24- 


-MAR- 


-82 


17J59 


02- 


-APR- 


-82 


13: 03 


25- 


-SEP- 


-82 


12129 


10 


-JAN- 


-82 


03:29 


23- 


-JAN- 


-82 


08: 05 


07- 


-N0U- 


-82 


15J56 


27- 


-APR- 


-82 


10*.21 


06- 


-APR- 


-82 


15:56 


30- 


-APR- 


-82 


08!36 
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F.TSKJ1 


4. 


C 


25-SEP-82 


12130 


G.TSKJ1 


4. 


c 


25-SEP-82 


12:30 


PON6.TSK52 


12. 


c 


25-SEP-82 


12:31 


BUZZ.TXTJ2 


4. 




12-HAR-82 


09513 


IZZY.TXT.l 


2. 




06-HAR-82 


14J33 


JIVE.TXTJ1 


1. 




16-N0V-82 


13J23 



Total of 2906. /3043. Blocks in 160, Files 

This example shows a directory listing in the standard format. 

The device and UFD are named at the head of the listing, along 
with the date and the time. All files in the UFD are listed 
because the user did not supply any filespecs. The files shown 
with a C in column 3 are contiguous files, in this case, task 
images. You may see files in a directory with an L in this 
position, signifying that the files are locked. Files are locked 
when they are closed improperly. See Section 4.4.6 for 
information on the UNLOCK command. 

>DIRECTORY/SUMMARY 

Storage used/allocated for Directory DBltC303»53 
1-N0U-82 14U5 

Total of 2892. /3033. blocks in 160, files 

This example displays the output produced by the /SUMMARY 

qualifier. If the user had supplied one or more filespecs in the 

command, the summary would cover the blocks used and allocated 
for the specified files only. 

>DIRECT0RY/FREE 

DBi: has 13742, blocks free. 3269280. blocks used out of 340670. 

Largest contiguous space = 5173, blocks 

124420 file headers are free? 131510. headers used out of 25593. 

This example displays information about the default device. 

>DIRECTQRY/FREE LB0 5 

DBO: has 6074. blocks free. 334596. blocks used out of 340670. 

Largest contiguous space = 3520. blocks 

3297, file headers are free? 22296. headers used out of 25593. 
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This example displays information about the pseudo device LBO:. 
Notice that the display gives the physical device name for the 
pseudo device. 



>DIR TI.CMD 

Directory DBltC303>53 
l-MAY-82 14!17 

TI.CMDM 1. 30--APR-82 08336 

Total of 1./5. blocks in 1. file 

This example displays information on the most recent version of 
the file named. See next example. 

>DIR TI.CMD?* 



Directory DB1 t [303 , 51 
l-MAY-82 14J17 

TI.CMDJ4 1. 30-APR-82 08136 

TI.CMD J 3 1. 27-APR-82 16.* 32 

TI.CMD J 2 1. 27-APR-82 16 J 29 

TI.CHDil 1, 27-APR-82 16t23 

Totsl of 4./20. blocks in 4. files 

This example displays information on all versions of the file 

named because the user supplied a wildcard for the version 
number . 



>DIR/FULL TI.CMD 

Directory DB1:C303t5D 
l-MAY-82 14S17 

TI.CMDS4 (300,56) 1./5. 30-APR-82 08136 C303,5D CRUEDi RUED , RUED ,R1 
Tot3l of 1./5. blocks in 1, file 

This example displays full information on the most recent version 
of the file named. The number in parentheses is the file 
identification number assigned by the system when the file is 
created. The first number is the file number, the second is the 
sequence number of the file. The QIC is the UIC of the owner, 
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and the final column is the protection status of the file. See 
notes . 

Protection status is listed in the order system, owner, group, 
world. See Section 4.1.5 for an explanation of protection status 
and how it can be altered. 



>DIRECTORY/BRIEF *.CMD 



I" i rectors BBltC303>53 

ADV.CMH* 2 

AZ.CMDS5 

BYE.CMIUl 

CLEAN. CMOS 1 

DAY.CMD.l 

DTC.CMDM. 

DUN.CMDJ4 

EDT.CMH»22 

LOX.CMDS 1 

VTK.CMDil 

This example displays brief information on the most recent 
version of all files of the type .CMD in the default UFD. 



>DIRECTORY/TODAY 



Directory DB2 ! C 303 7 53 
5-NQV-82 13 J 44 
Day of 5-N0V-82 

05JAN82.LGI, I. 0* 05-N0V-82 08 J 20 

2051CH4,ME«;i 339. 05-N0U--82 lOtil 

NEWINSDC3.RN0J7 10. 05-NOV-82 10J05 

2051CH4.MEM52 320. 05-N0V--82 10512 

FUT.MAIfI 1. 05--NOV-S2 13J05 

NEUINSDC3.RN0J6 9. 05-N0V-82 09 5 55 

NEUINSDC3.RN0J10 10. 05-N0V-82 10J39 

NEWINSDC4.RN0J3 7, 05-N0V-82 11M6 

FRK.CMDJ6 1. 05-N0V-82 13143 

NEUINSDC4.RN0.4 11. 05-N0Y-82 13M3 

LOG.LOGfl 0. 05-NOV-82 13143 

Total of 708. /736. blocks in 11. files 

In this example, the user asked for a directory of all files 
created the same day the command was issued. Note that the 
directory listing includes the date. See next example. 
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05JAN82.LGIrl 


0. 


2051CH4.MEMJ1 


339. 


2051CH4.MEMJ2 


320. 


FUT.MAI ,1 


i. 


FRK.CMDJ6 


1. 


L0G.L0GJ1 


2. 


Total of 672. /693. 


blocks 



>DIRECTQRY/T0DAY/EXCLUDE1*.RN0 5* 



Directory DB2:C303>53 
5-NQV-82 13M5 
*,RNQ»* excluded 
Day of 5-N0V-82 

05-N0V-82 08320 
05-N0V--82 10} 11 
05-N0V--82 10! 12 
05-NDV-82 13J0S 
05-N0V-82 13!43 
05--N0M-82 13! 43 

in 6 . files 

In this example, the user listed all files created the day the 
command was issued but excluded all files with the .RNO file 
type. Note that the filespec argument to /EXCLUDE has a wildcard 
version number. Observe also that the exclusion is noted in the 
heading of the directory listing. 

directory/ attributes yacht. seq 

sy::303»5:yacht.seq;i file organization; sequential 
created? 25-sep-1982 12j32 revised! 15-n0v--1982 08119 <5> 

file protection! crwed 1 rwed t rued r r"j 

record format! variable 

record attributes! carriage return 
file attributes! 

allocation^ 10 extend quantity=0 

This example shows the display from the /ATTRIBUTES qualifier to 
DIRECTORY. Attributes can be displayed for any file, but the 
full display has meaning only for RMS-11 files. 

>DIR *.TSK, C301»3703*.TXT 



Directory DB1 ! L 303 t 5 3 
20-N0V-82 09!39 

15-0CT-82 08! 55 

25-SEP--82 12!30 

25-SFP-82 12!30 

0I.--0CT--82 12J07 

25-SEP-82 12J31 

Total of 89. /89. blocks in 5. files 



CLOCK. TSKS3 


8. 


C 


F.TSK'Jl 


4. 


c 


G.TSKJ 1 


4, 


c 


TICTAC.TSK i 4 


19. 


c 


TREK.TSKJ1 


54. 


c 



4-29 



HANDLING FILES 



DIRECTORY (Cont.) 



Directory DB1 J [301 »3703 
20-N0V-82 09539 

FRONT, TXTil 3. 

EDITNEWS.TXT*12 25. 

0ZY.TXTJ3 2. 

TEXT.TXTJ1 151. 

NEW.TXTJ1 0. 

AWARE, TXTJ2 2. 

IZZY.TXTJ10 2. 



16-JUN-82 11523 
ll-SEP-82 10550 
ll-SEP-82 10550 
ll-SEP-82 10 5 50 
27-JUL-82 14536 
27-JUL-82 13548 
22-MAY-82 13542 



Total of 184, /205. blocks in 7. files 

Grsnd totsl of 273. /294, blocks in 12. files in 2, directories 

In this example, a user with the default UFD of [303,5] requested 
directory information on files in two directories. The default 
UFD was applied to the first files named, the *.TSK files; these 
were listed first in the display. The second set of files 
displayed, the *.TXT files, were from UFD [301,370], which was 
explicitly specified in the command. Note the locked file. 
Compare this example with the next one. 

>DIR E301f3703*,TXTt *,TSK 

Directory DB1 5 C301 > 3703 
20-N0Y-82 09540 



r nun i , i A i > j. 


j • 




ICJUIfOi 


X 1 4 *LO 


EDITNEUS.TXT512 


25. 




ll-SEP-82 


10 5 50 


0ZY.TXTJ3 


2. 




ll-SEP-82 


10550 


TEXT.TXTS1 


151. 




ll-SEP-82 


10550 


NEW.TXTf 1 


0, 


L 


27-JUL-82 


14 5 36 


AyARE,TXT?2 


2. 




27-JUL-82 


13548 


IZZY.TXTS10 


2. 




22-MAY-82 


13 5 42 


ADVENT, TSK51 


151, 


C 


23-MAY-82 


14512 


DUNGEON. TSKf 2 


242. 


C 


21-AUG-82 


09 5 08 


P0NG,TSKJ2 


12, 


C 


23-MAY-82 


14 5 13 


YCL0CK.TSK.6 


9. 


r 


08-JUL-82 


12 5 1 7 


STAR.TSKJ2 


102. 


C 


13-JUL-82 


09 5 07 


TICTAC.TSK55 


19, 


C 


01-AUG-82 


115 31 


VTCHS.TSKJ12 


26. 


c 


06--N0V-82 


15 5 39 


XCL0CK.TSKJ6 


9, 


c 


03-JUN-82 


16 5 48 


LIFE.TSKrlO 


4. 


c 


03-APR-82 


13 5 28 



Total of 758, /780. blocks in 16. files 

The command in this example is quite similar to the command used 
in the previous one, but notice the difference in results. The 
same user, with default directory [303,5], issued the command but 
this time the UFD [301,370] was specified first, for the *.TXT 
files. Even though no UFD was specified for the *.TSK files, 
these files were also listed from UFD [301,370] — not from 
[303,5]. This demonstrates that specifying a UFD in a DIRECTORY 
command resets the default UFD for the rest of the command or 
until another UFD is specified. 
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Notes 



For more information on directories in general, see Chapter 3 of 
the RSX-11M/M-PLUS Utilities Manual for more information. 

The full format for directory listings may include two dates. 
The first is the creation date of the file. The second date 
indicates the last time the file was opened by the system or a 
task, such as for backup. The decimal number in parentheses 
following the second date is the number of times the file has 
been opened in this fashion. 

Your directory is a file that you own, but which is kept in UFD 
[0,0] on the same volume as your UFD. In UFD [0,0] you will find 
the Master File Directory (MFD) , which is a file named 
000000. DIR. The MFD is the directory for UFD [0,0]. All UFDs on 
the volume appear in this directory in the same form. The 
directory for UFD [303,5] is called 303005. DIR; the directory 
for UFD [7,40] is 007040. DIR, and so forth. 

These directory files have file protection like all other files. 
The protection is for the directory file, not for files in the 
directory. Since the directory is a file, READ access is the 
right to list the directory, and WRITE access is the right to 
create files in the directory. If you do not have EXTEND access 
to a directory, you may be denied the right to create more than a 
certain number of files in the directory. DELETE access means 
the right to delete the directory file. If you delete a 
directory file, you must use the VFY utility to recover files 
from the directory. See Chapter 9 of the RSX-11M/M-PLUS 
Utilities Manual. 



4.3.2 DELETE 

DELETE deletes specified files and releases the storage space the 
files occupy. 



Format 



DELETE[/qualifier] 
File(s)? filespec[s] 

DELETE[/qualifier] filespec[s] 

Command Qualifiers 

/LOG 

/QUERY 

/DATE : dd-mmm-yy 

/S I NCE : dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH:dd-mmm-yyy 

/TODAY 

/EXCLUDE: filespec 
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Parameter 

f ilespec[s] 

Specifies the file or files to be deleted. 

You must supply the name, type, and version number fields of the 
filespecs of the files you wish to delete. Device and UFD fields 
default to your current device and UFD. You can use wildcards in 
any filespec field except the device field. You need not supply 
a file type to delete a file with a null file type. 

You can only delete files to which you have DELETE access. 

To name more than one file for deletion, separate their filespecs 
with commas. 

Command Qualifiers 

/LOG 

Specifies that a list of the files deleted be displayed on your 
terminal . 

/QUERY 

Specifies that you wish to decide which files should be deleted 
on an individual basis. Each file that is specified in the 
command is named. You may enter one of four characters: 

Y - Deletes file named and goes on to next file. 

N - Does not delete file named and goes on to next file. 

G - (Go) Deletes the file and goes on to delete all other 

files specified. 
Q - (Quit) Does not delete the file and exits the task. 

No more files are deleted. 

Remember that you can specify files by default or wildcard. See 
examples. If you do not specify a version number, /QUERY is the 
default. See the examples. 

/DATE : dd-mmm-yy 

The /DATE qualifier specifies that you wish the DELETE command to 
affect only files created on the date given. 

/SINCE: dd-mmm-yy 

The /SINCE qualifier specifies that you wish the DELETE command 
to affect only files created on or since the date given. 

/THROUGH: dd-mmm-yy 

The /THROUGH qualifier specifies that you wish the DELETE command 
to affect only files created on or before the date given. 
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/SINCE:dd-mmin-yy/THROUGH:dd-mmm-yy 

The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the DELETE command to affect only files created 
within that range. 

/TODAY 

The /TODAY qualifier specifies that you wish the DELETE command 
to affect only files created on the same day the command is being 
issued . 

/EXCLUDE: filespec 

The /EXCLUDE qualifier specifies that you wish the DELETE command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly, or as "*" wildcard. 

Examples 

>DELETE 

File<s)? *.DAT?* 

This example deletes all versions of all files of the type .DAT. 

>DELETE FILE.FIL.il i 53, ,TXT»5 

This example deletes versions 1 and 3 of FILE.FIL, and version 5 
of FILE. TXT. Note that no filename or type is specified for 
version 3, and no name for .TXT;5. 

>DELETE/GUERY 
File(s)? *.TMPJ* 

Delete file DBiU303.530GFiE.THF CY/N/G/Q3? Y 

Delete file DB1 i C303 , 5JTR0LL. .TMP i 1 C Y/N/G/Q l"? Y 

Delete file DB1 J E303 , 530KC , THP i 1 [Y/N/G/Q3? Y 

Delete file DB1 t C303r 53ELF , THP J i EY/N/G/Q3? N 

Delete file DB1 J [303 » 51H0BBIT , THP i I CY/N/G/Q3? N 

Delete file DB1 I L303, 51SNIPE . THP M CY/N/6/Q3? G 

The followina files hsve been deleted; 

DB1!C303»5DSNIPE,TMPJ1 

DBi:C303r53SN0PE.TMP52 

In this example, the user specified all files having the type 
.TMP in the DELETE command. Three files were deleted at the 
user's choice, and two were retained. The user then directed 
that all remaining files with the type .TMP be deleted. There 
were two more files, which were deleted and listed. 
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PURGE 



CY/N/G/GD? 


r 


i:y/n/g/Q3t 


fj 


CY/N/G/OJ? 


Y 


CY/N/G/03V 


Y 


EY/N/G/Q3? 


Y 


r Y/N/G/G3? 


Y 


EY/N/G/G3? 


H 



>DELETE *.DOC 

Delete file DBO I C303 , 53UITCH . DOC 5 2 

Delete file DBO X C303 r 5 JDRY , DGC i 4 

Delete file DBOt L303.53PAYCHECK . DOCS 1 

Delete file DBO t [.303 , SJLOArUNG , DOC i 3 

Delete file DB0t C303 r 53L .OADING , DGC 5 4 

Delete file DBO : C303 , 53L0ADJ.NG . DOC 5 5 

Delete file DB0J C303. S3L0ADING . DOC if 6 

In this example, the user specified the file type .DOC and a 
wildcard for the file name. Because no version number was given, 

une UEiLiEii.£i uOiruTiauu . ucl am. l€G uw uiitr /yuiliKi ^uaniici r cudui. Any 

the user to choose which files to delete. 



>DELETE/L0G *.L5Ti* 

The following files have been deleted: 

DBi:C303r53R ANGER. LSTJi 

DBi:C303 J 53T0NTO.L3T»l 

DBi:C303 f 53REID,LST?l 

DBi:C303»5 3SILvER.L.ST5 1 

DB1:C303t5DSC0UT.LS7t1 

DBl!C303»5 3H0RNET.l.3T,*l 

DBi:C303,53KAT0.LST?l 

In this example, the user specified all files with the type .LST 
in the DELETE command and asked that they be listed as they are 
deleted . 

Notes 

You must have DELETE access to delete a file. 

If you wish to delete using wildcards, it is wise to get a 

directory listing using the same filespecs you plan to delete. 

In this way, you can be sure you are not deleting more files than 
you intend to delete. 

Remember that under the default file protection on RSX-11M/M-PLUS 
systems, you have DELETE access to your own files and all files 
in directories with the same group number. 

See Chapter 9 for DELETE commands directed to the queue manager. 



4.3.3 PORGE 

PURGE deletes all but the latest versions of files, and releases the 
storage space the deleted files occupy. 

Format 



PURGE[/qualif ier[s] ] 
File(s)? filespec[s] 

PURGE[/qualif ier [s] ] filespec[s] 
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Command Qualifiers 

/[NO] LOG 

/KEEP:n 

/DATE:dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 

Parameter 

f ilespec[s] 

Specifies the file group or file groups to be purged. 

Because of the nature of the command, you cannot include a 
version number in the filespec. Multiple filespecs must be 
separated by commas. Wildcards can be substituted for UFD, name, 
and type fields. 

You can purge any files to which you have DELETE access. 

Command Qualifiers 

/[NO] LOG 

Specifies that the files deleted by PURGE be listed on your 
terminal. The default is /NOLOG. 

/KEEP:n 

Specifies that the n latest versions of a file be retained. 

If you do not use this qualifier, all versions but the most 
recent of a given file are deleted. That is, the default form of 
the command includes the qualifier /KEEP:1. With the qualifier 
explicitly stated, all but the n highest numbered versions are 
deleted. PURGE assumes that version numbers are in numerical 
sequence and without missing numbers. See example. 

If more than one filespec is given with the /KEEP qualifier, all 
but the latest n versions of all files listed are deleted. 

/DATE : dd-mmm-yy 

The /DATE qualifier specifies that you wish the PURGE command to 
affect only files created on the date given. 

/SINCE:dd-mmm-yy 

The /SINCE qualifier specifies that you wish the PURGE command to 
affect only files created on or since the date given. 

/THROUGH : dd-mmm-yy 



to affect 



The /THROUGH qualifier specifies that you wish the PURGE command 

given . 
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/SINCE :dd-mmm-yy/THROUGH:dd-mmm-yy 

The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the PURGE command to affect only files created 
within that range. 

/TODAY 

The /TODAY qualifier specifies that you wish the PURGE command to 
affect only files created on the same day the command is being 
issued . 

/EXCLUDE: filespec 

The /EXCLUDE qualifier specifies that you wish the PURGE command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly, or as "*" wildcard. 

Examples 

> PURGE 

File(s)? TEMPER, TSK 

In this example, all versions of TEMPER. TSK but the latest are 
deleted. 



^DIRECTORY ASDIC . Tfil r * ? ELPAS0.TEX5* 



Directory DB1 5 C 303 > 53 
20-N0V-82 13 Mt 



ASDIC. TM151 


1 . 


20-HGU-82 


13 5 41 


ASDIC, TM1S2 


1 , 


20-N0U-82 


13541 


ASDIC. TM1TJ 


1 . 


20--NQV-82 


13541 


ASDIC. TM1?4 


0, 


20-N0V-82 


13U1 


ASDIC. TMlfS 


1. 


20-N0V-82 


13 5 42 


ELPAS0.TEXJ1 


1 . 


20--N0V-S2 


13542 


ELPASO.TEX 5 2 


1 . 


20-N0V-82 


13 5 42 


ELPAS0.TEXJ3 


1. 


20-N0Y-82 


13 5 42 


elpaso.tex; 5 


1 . 


20-N0V-82 


13543 


ELPASO.TEX56 


1. 


20-N0V-82 


13 5 43 



Totsl of 9./4S. blocks in 10. files 



>PURGE/L0G/KEEP 5 3 ASDIC. TM1 

The following files have been deleted? 
DB15C303>5DASDIC,TM1 »1 
DB15i:303f53ASIiIC,TMl!2 
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>PURGE/L0G/KEEPS3 ELPASO.TEX 

The following files have been deleted; 
DB1 J [303» 5 3ELPAS0.TEX !1 
DBltr.303, 5 3ELPAS0.TEX? 2 
DEI I C303 , 5 3ELPASQ . TEX r 3 



^DIRECTORY ASDIC :. TM1 ?# r ELPASO.TEX;* 
Directory DB1JC303»53 
20~NQv~82 13M6 



ASDIC. TM1S3 


1 . 


20--N0V-B2 


13M1 


ASDIC. TM154 


0. 


20-N0V-82 


13J41 


ASDIC. TM1?5 


1. 


20-N0'v'-82 


13«. 42 


ELPASO.TEX55 


1. 


20-N0v~82 


13M3 


ELPASO.TEX J 6 


1. 


20-N0U-82 


13143 



Totsl of 4./20. blocks in 5. files 

In this example, the user started with two sets of five files. 
The five files named ASDIC. TM1 have version numbers in order. 
The five files named ELPASO.TEX are numbered 1,2,3,5,6. The user 
issued a PURGE command with the qualifier /KEEP:3. Versions 4, 
5, and 6 of ASDIC. TM1 were kept, but only versions 5 and 6 of 
ELPASO.TEX. This is because the /KEEP: 3 qualifier does not save 
the three highest numbered files, but rather the highest numbered 
file and the next two lower numbered files of the same name in 
numerical sequence. If there had been a file ELPAS0.TEX;4 , it 
would have been saved. Since there was none, the PURGE command 
task exited, its work done. 

Notes 

You can purge any file to which you have DELETE access. 



4.3.4 COPY 

COPY copies files. 

COPY creates a sequential file copy of one or more sequential files, 
or of records with either indexed or relative file organization. 



Format 



COPY [/qualifier [s] ] 

From? infilefs] [/qualifier] 

To? outfile 

COPY[/qualifier [s] ] infile [s] [/qualifier] outfile 
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Command Qualifiers 

/[NO] CONTIGUOUS 

/REPLACE 

/OWN 

/BLOCKSIZEtn 

/DATE:dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH :dd-mmm-yy 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE : f i lespec 

Parameters 

inf ile[s] 

Specifies the input file or files to be copied. 

You must have READ access to a file to copy it. 

Multiple filespecs, separated by commas, are accepted. If you 
specify multiple input files, they will be concatenated in a 
single output file in the order that you specify them. 

outf ile 

Specifies a single output file to which the input file or files 
is copied. 

You must have WRITE access to the UFD to which you wish to send a 
copy. Under the default protection, you have WRITE access to 
your UFD and to all UFDs with the same group number. 

You can change the name, type, and version number of the file 
when you enter this parameter. Wildcards in the place of the 
name and the type leave the name and type unchanged. If you use 
a wildcard in either of these fields, you must use a wildcard in 
both. 

The output file can be created by COPY. The output file need not 

exist when you issue the command. If a file of the same name and 
type already exists, then the file you create has a version 

number one higher than the highest existing version. If you 

specify a version number for the output file field, then a file 

of that version number is created. If such a file already 
exists, the operation fails. 

Wildcards are acceptable for output files if the destination is 
another UFD. If you have multiple input files and use wildcards 
for the output file, you create multiple output files, each with 
the name and type of the corresponding input file. 

You can send copies to devices as well as to UFDs. See examples. 

You can also use the COPY command to create multiple copies of 
the same file with the same or different names. 
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Command Qualifiers 

/[NO] CONTIGUOUS 

Specifies that the output file must be contiguous. If this 
qualifier is not used, then only files that are already 
contiguous remain contiguous when copied. 

The default is /NOCONTIGUOUS. 

/REPLACE 

If the output file- has the same name, type, and version number as 

an already existing file at the destination, the first file is 

deleted and the file you have sent replaces it. The name, type 
and version number stay as they were. 



/OWN 



Changes the ownership of the file being copied from the source 
UIC to the destination UIC. After execution, both UICs own 
copies. If you do not specify /OWN, the original UIC owns both 
copies. If you are copying from another directory to your own, 
use this qualifier. 



/BLOCKSIZEm 



Defines block size for magnetic tape, n can be octal or decimal; 
if decimal, you terminate n with a decimal point. For example: 

/BLOCKSIZE:25. 

/DATE:dd-mmm-yy 

The /DATE qualifier specifies that you wish the COPY command to 
affect only files created on the date given. 

/SINCE :dd-mmm-yy 

The /SINCE qualifier specifies that you wish the COPY command to 
affect only files created on or since the date given. 

/THROUGH :dd-mmm-yy 

The /THROUGH qualifier specifies that you wish the COPY command 
to affect only files created on or before the date given. 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 

The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the COPY command to affect only files created 
within that range. 



/TODAY 



The /TODAY qualifier specifies that you wish the COPY command to 
affect only files created on the same day the command is being 
issued. 
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/EXCLUDE:filespec 

The /EXCLUDE qualifier specifies that you wish the COPY command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 

Examples 

>C0F'Y 

From? C303t41TSKBLD.CMD 

To? TEJKBLD . Cf'i-J 

This example copies TSKBLD.CMD from [303,4] to the current UFD 
and device. The file is still owned by the source UIC. 

>C0PY *.BAS DKIJ 

This example copies all files with the file type .BAS from the 
current device and UFD to the same UFD on the volume mounted on 
device DK1 : . 

>C0PY/0UN TSKBLD.CMD E303.43BLBFIL.CMD 

This example copies TSKBLD.CMD from the current UFD and device to 
[303,4], assigns ownership to the destination UIC, and also 



>C0PY/C0NTIGU0US LITTER. DAT *.* 

This example creates a new version of the file LITTER.DAT. The 
new version is contiguous. 

>C0PY 0LDl.FILr0Lri2.FIL 
To? NEW. ONE 

This example copies two previously existing files into one new 
file. 



>C0PY CHARLA.DMP TT41: 

This example prints a copy of CHARLA.DMP on TT41:. This is a 
convenient means of sending messages longer than one line. If 
the terminal is busy at the time you send the copy, the copy is 
held until the terminal is clear and then sent. 



>C0PY FLY. TXT SPIDER.TXT 

This example creates the file SPIDER.TXT with the same contents 
as FLY. TXT, both on the current device and UFD. 
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Notes 

C is the short form of copy. 

COPY does not affect file organization. If you wish to change 
file organization, use the CONVERT command, Section 4.3.6. 

Usually, READ access is much broader than WRITE access. Under 
the default protection setup, your READ access covers the whole 
system, but your WRITE access is limited to other UFDs with the 
same group number. Thus, you can copy from many places that you 
cannot copy to. 

Also, when you copy a file, you do not copy its protection code. 
Your copy has the default protection code. Use SET PROTECTION if 
you want to change the protection code of the copy, 

Note that you can change the name, type, and version number of a 
single file as you copy it. 



4.3.5 RENAME 

RENAME changes the name, type, or version number of an existing file. 

Format 

RENAME[/qualifier [s] ] 

Old file name? infile 

New file name? outfile 

RENAME [/qualifier [s] ] infile outfile 

Command Qualifiers 

/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/THROUGH :dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH:dd-mmm-yyy 

/TODAY 

/EXCLUDE: filespec 
Parameters 
infile 

Specifies the file to be renamed. 

You may give a wildcard for either the file name or the file 
type, or both. If you use a wildcard in these fields, you must 
supply an entry in the version number field. This may be a 
wildcard. 

If you give a wildcard for version number, all versions retain 
their old version numbers. If no version number is supplied, 
only the highest version of the named file is renamed. It has 
the same version number as the old file. If other files having 
the new name exist, then you receive an error message. 
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outf ile 

Specifies the new name for the file. 

Wildcards leave that portion of the filespec the same as before. 
No wildcard is needed for the version number. 

Command Qualifiers 

/DATE:dd-mmm-yy 

The /DATE qualifier specifies that you wish the RENAME command to 
affect only files created on the date given. 

/SINCE :dd-mmm-yy 

The /SINCE qualifier specifies that you wish the RENAME command 
to affect only files created on or since the date given. 

/THROUGH :dd-mmm-yy 

The /THROUGH qualifier specifies that you wish the RENAME command 
to affect only files created on or before the date given. 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 

The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the RENAME command to affect only files created 
within that ranqe, 

/TODAY 

The /TODAY qualifier specifies that you wish the RENAME command 
to affect only files created on the same day the command is being 
issued. 

/EXCLUDE: filespec 

The /EXCLUDE qualifier specifies that you wish the RENAME command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 

Examples 

•-RENAME 

Old file name? INTR0.TXT 

New file name? APPENDIX.TXT 

In this example, the most recent version of INTR0.TXT becomes 
APPENDIX. TXT;1. 

•RENAME IZZY.TXT5 4 FIZZY,* 

In this example, IZZY.TXT;4 becomes. FIZZY.TXT; 1. Other versions 
of IZZY.TXT are not affected. 
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>RENAME AHA, DOC? 4 *.*5 11 
In this example, AMA.DOC;4 becomes AMA.DOC;ll. 

>RENAME MAIN.TSK.* EXTRA, TSK 

In this example, all files named MAIN.TSK are renamed EXTRA. TSK. 
The version numbers remain the same, regardless of sequence and 
order of file creation. 

>RENAME MAIN.TSK?* SUB.* 

In this example, all versions of MAIN.TSK are renamed SUB. TSK. 
Versions are in the order of creation, with numbers unchanged. 

>REN EXHAUST.*?* REFRESH.* 

In this example, all files named EXHAUST of whatever type are 
renamed REFRESH. Their file types remain the same. Note that a 
wildcard is given for the input file type. This makes an entry 
in the version number field mandatory. 

Notes 

You cannot rename files across devices. 

Using wildcards is also tricky. Experiment before committinq 
yourself. ^ 



4.3.6 CONVERT 

The CONVERT command invokes the RMSCNV utility, which moves records 
fom one file to another. RMSCNV reads records from an input file and 
writes them to an output file. The action of RMSCNV depends on the 
organization — sequential, relative, or indexed — of the two files, 
and on the qualifiers you include in the CONVERT command. See the 
RMS-11 documentation supplied with your system for more information. 



Format 



CONVERT[/qualifier[s] ] 
Input file? infilespec 
Output file? outfilespec 

CONVERT [/qual if ier [s] ] infilespec outfilespec 
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Command Qualifiers 

/[NO] APPEND 

/BLOCK_SIZE:n 

/ [NO] FIXED_CONTROL 

/[NO] IDENTIFICATION 

/INDEXED 

/KEY[:n] 

/[NO]LOG_FILE[:filespec] 

/[NO]MASS_INSERT 

/MERGE 

/[NO]PAD[: [#]arg] 

/RELATIVE 

/[NO] REPLACE 

/SEQUENTIAL 

/[NO] TRUNCATE 

Parameters 

inf ile 

Specifies the file that is the source of records to be written to 

the output file. CONVERT reads input records sequentially, 

regardless of the organization of the input file. No wildcards 
permitted. 

outf ile 

S~ecifiec the file that is to receive the records from the input 
file!" ^The "default file organization for the output file is 
sequential. If the output file is not sequential, use the 
/RELATIVE or /INDEXED qualifier to indicate the organization. If 
the output file is to be sequential, CONVERT can create the file; 
it need not exist prior to your entering the CONVERT command. 
CONVERT cannot create indexed or relative files; these must have 
been created prior to your entering the CONVERT command. See the 
RMS documentation supplied with your system. No wildcards 
permitted. 

Command Qualifiers 

/[NO] APPEND 

Specifies that you wish RMSCNV to append records to the end of an 
existing sequential file. If the output file is not sequential, 
RMSCNV ignores the qualifier. You cannot use both /APPEND and 
/REPLACE in the same command line. 

The default is /NOAPPEND, but the action taken depends on the 
presence of the /REPLACE qualifier in the command line. If you 
specified /REPLACE, RMSCNV performs the replace operation. If 
you did not specify /REPLACE, RMSCNV creates the next higher 
version of the file. 

This qualifier is the equivalent of the /AP switch in an RMSCNV 
command line. 
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/BLOCK SIZE:n 



Specifies the physical block size of an output file being created 
on magnetic tape. n can be from 18 through 8192 characters. 
RMSCNV rounds this value up to the next multiple of 4. If you do 
not specify this qualifier, the default tape block size is 512 
characters . 



This qualifier is the equivalent of the /BL switch in an 
command line. 



RMSCNV 



/[NO]FIXED_CONTROL 

The /FIXED_CONTROL qualifier directs RMSCNV to handle 
variable-with-f ixed-control (VFC) format records in either the 
input file or the output file. If the fixed-control area of the 
input file and the output file are the same size, RMSCNV performs 
a straightforward copy. See the RMS-11 documentation supplied 
with your system for information on how RMSCNV handles other 
combinations. If you include this qualifier and neither file 
specifies VFC records, RMSCNV terminates. 



This qualifier is the equivalent of the /WF switch in 
command line. 



an RMSCNV 



The default is /NOFIXED_CONTROL. This means that if one of the 
named files contains VFC records, the fixed-control area of each 
record is ignored. That is, if the input file includes VFC 
records and the output file does not, only the variable portion 
of each record is written to the output file; if the output file 
includes VFC records and the input file does not, data is written 
only into the variable portion of each output record. 

/ [NO] IDENTIFICATION 

Requests that RMSCNV print its current version number and patch 
level on your terminal. See the RMSCNV documentation for more 
information. 



This qualifier is the equivalent of the /ID switch in an 
command line. 



RMSCNV 



The default is /NOIDENTIFICATION. 
/INDEXED 

The /INDEXED qualifier informs RMSCNV that the output is of 
indexed organization. Regardless of their organization, all 
input files are read sequentially. 

RMSCNV reads each record from the input file, then applies the 
output file's record format, that is, key placement within the 
record, to the data. If you do not specify the /KEY qualifier 
with a value, the key of reference is the primary key; 
otherwise, it is the key you specify. 
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This qualifier is the equivalent of the /FO:IDX switch in an 
RMSCNV command line. 

See the RMSCNV documentation for more information. 

/KEY[:n] 

Indicates the key that establishes the order in which records are 
read sequentially from an indexed input file and written to the 
output file, n can be from through 9. The default is n=0 and 
indicates the primary key; n=l is the first alternate key; n=9 

j. a Lilt; niFiLii ailcLiiaic J\.ey • 

This qualifier is the equivalent of the /KR switch in an RMSCNV 
command line. 

/[NO]LOG[:filespec] 

Directs RMSCNV to summarize processing in a log. If you do not 

include a filespec, the log appears on your terminal. If you 

name a file, that file will be created and written to by RMSCNV. 
The log includes the following elements: 

1. The command string in RMSCNV format. This will not be the 
same as DCL format. 

2. Copies of all error messages produced during execution. 

3. An indication of any duplicate-key problems. If the log is 
appearing on the terminal, the indication consists only of 
the following message: 

SOME DUPLICATE RECORDS NOT WRITTEN 

If the log is being written to a file, RMSCNV supplies the 
indicator DUP RCD= followed by the first 72 characters of the 
record that could not be written. 

This qualifier is the equivalent of the /SL switch in an RMSCNV 
command line. 

The default is /NOLOG meaning that only normal error messages 
appear on your terminal. 

/[NO]MASS_INSERT 

Directs RMSCNV to activate the RMS-11 mass insert I/O technique 
and then use sequential put operations to insert records into the 
output file. 

This is the equivalent of the /MA switch in an RMSCNV command 
line . 

The default for nonsequential file organization is 
/NOMASS_INSERT. See the RMS-11 documentation supplied with your 
system for further information. 
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/MERGE 

Directs RMSCNV to copy records from the input file into the 
output file. Both files must be of the same organization. 

/[NO]PAD[: [#]arg] 

Directs RMSCNV to pad records read from the input file to the 
output file's record length before writing them to the file. If 
you specify the qualifier without an argument, the pad character 
is null. If you do not include the number sign (#) , the argument 
can be any printing ASCII character except: the number sign, 
question mark (?) , or commercial-at sign (@) . If you include the 
number sign (#) , n can be an octal number from through 377, 
representing the full ASCII character set. This enables you to 
use the three excluded characters as pad characters by specifying 
43 for #, 77 for ?, and 100 for @. 

Use this qualifier only when the output file specifies 
fixed-length records. 

This qualifier is the equivalent of the /PD switch in an RMSCNV 
command line. 

/RELATIVE 

The /RELATIVE qualifier informs RMSCNV that the output file is of 
relative organization. Regardless of their organization, all 
input files are read sequentially. 

The /RELATIVE qualifier is the equivalent of the /PO:REL switch 
in an RMSCNV command line. 

RMSCNV reads records from the input file and writes them into 
successive record cells of the output file, beginning with cell 
1. If RMSCNV encounters a cell containing a record, it 
terminates with an error message. All records written to that 
point are in the output file. You should examine the two files 
to determine how far the processing went. 

See the RMS-11 documentation supplied with your system for more 
information. 

/[NO] REPLACE 

The /REPLACE qualifier directs RMSCNV to supersede an existing 
sequential file. RMSCNV replaces a file in the output account 
with the same file name, type, and version number. You cannot 
use /REPLACE and /APPEND in the same command line. 

The /REPLACE qualifier is the equivalent of /SU in an RMSCNV 
command line. 

The default is /NOREPLACE, but the default action depends on 
whether the command line includes an /APPEND or not. If you 
specify /APPEND, RMSCNV performs the append operation. If you do 
not specify /APPEND, RMSCNV creates the next higher version of 
the file. 
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/SEQUENTIAL 



The /SEQUENTIAL qualifier informs RMSCNV that the output file is 
of sequential organization. Regardless of their organization, 
all input files are read sequentially. The default output file 
organization for RMSCNV is sequential. 

This qualifier is the equivalent of the /FO:SEQ switch in an 
RMSCNV command line. 

If you *o not specify either the /APPEND or /REPLACE qualifier, 
and the output file is sequential, the output file need not exist 
before you issue the CONVERT command. 

If the output file does not exist, RMSCNV creates an output file 
with the record attributes of the input file. RMSCNV then reads 
records from the input file and writes them sequentially into the 
new output file. 

If the output file already exists, and the command does not 
include the /APPEND qualifier, RMSCNV creates the next higher 
version of the file. RMSCNV then reads records from the input 
file and writes them sequentially into the new version of the 
output file. 

If the output file exists and you specify the /REPLACE qualifier, 
RMSCNV reads records from the input file and writes them 
sequentially into the output file, starting with the beginning of 
the file. 

If the output file exists and you specify the /APPEND qualifier, 
RMSCNV reads records from the input file and writes them into the 
output file, starting with the record position following the last 
record already in the file. 

/[NO] TRUNCATE 

Directs RMSCNV to truncate records read from the input file to 
the output file's record length before writing them into the 
output file. The trailing bytes of the record are truncated. 

The default is /NOTRUNCATE. If you do not specify /TRUNCATE and 
the input records are too long, RMSCNV terminates with the 
following message: 

CON — Input and output record sizes do not correspond 

Examples 

>C0NVERT 

Input file? FOO.BAR 

Output file? POOH .BAR 

The output file does not exist. RMSCNV creates the sequential 
file POOH. BAR and copies the records from FOO.BAR into it. 

>CONVERT FOO.BAR POOH, BAR 
This example is the equivalent of the previous one. 
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>CONVERT/INIiEXED GRIZZLY. BAR CROW. BAR 

RMSCNV reads each record of the input file GRIZZLY. BAR 
sequentially and examines the contents of the primary key field, 
which is defined as an attribute of CROW. BAR. RMSCNV then 
inserts the record into CROW. BAR. 



>CONVERT/RELATiyE/KE:Y:i. SAND, BAR MAX, BAR 

RMSCNV reads the indexed input file SAND. BAR, using the first 
alternate key of the file to establish the sequence of access. 
Then RMSCNV writes the records sequentially into an empty 
relative output file MAX. BAR, starting with record cell 1. 

Note that the /RELATIVE qualifier refers to the organization of 
the output file and the /KEY qualifier refers to the organization 
of the inout file. 



>conmert/arpend/sequential/key:2 running, BAR CORNER. BAR 

RMSCNV reads the indexed input file RUNNING. BAR, using the second 
alternate key of the file to establish the sequence of access. 
Then RMSCNV appends the records at the end of the existing 
sequential output file CORNER. BAR. 

If the /APPEND qualifier had not been specified, RMSCNV would 
have created the next higher version of CORNER. BAR and written 
the records from RUNNING. BAR into it. 

>CONVERT/RELATIVE/FIXED..C0NTR0L MAMA, BAR PAPA , BAR 

RMSCNV reads fixed-length records from the indexed input file 
MAMA. BAR, using (by default) the primary key of the file to 
establish the sequence of access. The RMSCNV writes the records 
sequentially in a VFC format into the existing relative file 
PAPA. BAR. Record format is an attribute of each file. As each 
record is written, the first bytes become the fixed control area. 

>conuert/truncate/block_size:io24/append/key;? brer, bar 

Output file? MM3i6RER.BCK 

RMSCNV reads the indexed input file BRER. BAR, using the file's 
ninth alternate key to establish the sequence of access. The 

PM.QPMX7 IJ-KTl-CiO +-VtQ Vt^rirwAc 4-*-v m-a^tn^J-i /, 4- -n ** ~ J. — ,- « . i- 1 — — 4-1 _ J 

»->i ._* V i. . w,*.j.^^u %.»..*> j.^\,vi.ua i_\-* iuayuct.4^ K~d^J^: , u J. ullKJd i_ J. liy LliCLLl t_U 

the output file's record length before adding them to the end of 
the existing file, and formatting the tape blocks to 1024 bytes 
each . 



Notes 



You must have a clear understanding of RMS-11 and the various 

forms of file organization it supports before using the CONVERT 

command. See the RMS-11 documentation supplied with your system 
for further information. 
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Sequential files used with the CONVERT command have been created 
by FCS. 

The CONVERT command replaces some functions of the COPY and MERGE 
commands in the previous release of RSX-11M-PLUS DCL. 



4.4 OTHER FILE-RELATED COMMANDS 

The commands in this section perform varied actions on your files. 
The TYPE command displays files on your terrninax. The PRINT comman^ 
prints files on the system line printer. The APPEND, MERGE, and SORT 
commands alter the contents of certain files. The DIFFERENCE command 
displays the differences between two files and the UNLOCK command 
unlocks locked files. 



4.4.1 TYPE 

TYPE prints selected files on your terminal. 

Format 

TYPE[/qualifier'[s] ] 
File(s)? filespec[s] 

TYPB f /qi.ial i f i <=r [ g] j fil esper? [ s] 

Command Qualifiers 

/DATE:dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 

Parameter 

filespec [s] 

Specifies the file or files to be printed on your terminal. 

You can specify any file to which you have READ access. 

The file name and type must be specified explicitly or with a 
wildcard (*) . If no version is specified, the most recent 
version is printed. A wildcard in any field prints every file 
that matches otherwise. Both the * and the % wildcards are 
accepted. 

You can also specify a device and UFD. If you do not, these 
fields default to the current device and UFD. 

Multiple filespecs must be separated by commas. 
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Command Qualifiers 

/DATE:dd-mmm-yy 

The /DATE qualifier specifies that you wish the TYPE command to 
affect only files created on the date given. 

/SINCE:dd-mmm-yy 

The /SINCE qualifier specifies that you wish the TYPE command to 
affect only files created on or since the date given. 

/THROUGH :dd-mmm-yy 

The /THROUGH qualifier specifies that you wish the TYPE command 
to affect only files created on or before the date given. 

/S I NCE : dd-mmm-yy/THROUGH : dd-mmm-yy 

The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the TYPE command to affect only files created 
within that range. 

/TODAY 

The /TODAY qualifier specifies that you wish the TYPE command to 
affect only files created on the same day the command is being 
issued. 

/EXCLUDE:f ilespec 

The /EXCLUDE qualifier specifies that you wish the TYPE command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 

Examples 

>TYPE 

FileCs)? LOGIN. CMH 

.ENABLE QUIET 

.IF <CLI> EG 'MCR 1 SET /DCL=TIt 

SET TERMINAL LOWER 

ASSIGN DBtt SYO: 

SAZ 

This example prints the file LOGIN.CMD from the current device 
and UFD on your terminal. 

>TYP C303fl23L0GIN.CMD 

.IF <CLI> EQ "MCR 1 ASN DBlt=SYJ 

.IF <CLI> EQ "DCL" ASSIGN DB1J SYO! 

TYPE L0GIN.TXT 

TYPE A. A 

SET /DCL=Ti: 

This example prints the file LOGIN.CMD from the current device 
and UFD [303,12] on your terminal. 
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>type c*»*:*.fil;* 

This is the beginning of a file named ARTHUR , F : I L . 
It 3oes on for several lines. 



THIS MARKS THE INITIATION OF A FILE CALLED ALBERT . FIL. . 
IT TOO CONTINUES AT SOHE LENGTH, 



Now comes a file that starts like this called Z.FIL. 
And some more. 



At 1 a s t r we reach the beginning of a file named FILLIE.FIL. 
Adain some more text and then 



The last two lines of FILLIE.FIL. 
ZZZZZZZ2ZZ22ZZZZZZZZZZZZZZZZ 



This example prints on your terminal all versions of all files 
having the type .FIL located on the current device. 



Notes 



In general, RSX-11M/M-PL0S documentation uses the term "print" to 

refer to any output sent to a terminal and "type" to refer to any 

user input from a terminal. The name of the TYPE command is an 
exception to this rule. 

If you are typing multiple files, the CTRL/O feature works in a 
slightly different fashion. When you enter a CTRL/0, output is 
discarded until you type another CTRL/O or until the beginning of 
the next file is reached, whereupon output is sent to your 
terminal again. This leaves you free to use CTRL/O on a 
file-by-file basis. 

You can type any file, but normally only ASCII text files are 
readable. 



4.4.2 PRINT 

PRINT queues files for printing on a line printer. It can also be 
used to queue jobs for other output devices. PRINT defines a QMG 
print job. 



Format 



PRINT [/qualifier [s] ] 

File(S) filespec [/qualifier [s] ][ , filespec[s]] 

PRINT[/qualif ier [s] 1 f ilespec[/qualif ier [s] 1 [ , filespec[s]] 
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Command Qualifiers File Qualifiers 

/[NO] DELETE /[NO] DELETE 

/COPIESrn /COPIESin 

/ [NO] TRANSFER / [NO] TRANSFER 

/DEVICEtddnn: 

/[NO] HOLD 

/JOB_COUNT:n 

/[NO] JOB_PAGE 

/QUEUE tqueuename 

/[NO] UPPERCASE 

/[NO] LOWERCASE 

/[NO]WIDE 

/PAGE_COUNT:n 

/NAME: jobname 

/PRIORITYtn 

/FORMS :n 

/LENGTH :n 

/[NO] RESTART 

/[NO]FLAG_PAGE 

/AFTER: (dd-mmm-yy hh:mm) 

(mn/dd/yy hh:mm) 
/[NO]WIDE 

Parameter 

f ilespec [s] 

Specifies the file or files to be printed on the line printer. 

Multiple filespecs must be separated by commas. 

The * can be used in UFD, name, type, and version number fields, 
but only to stand for the entire field. Wildcarding of the form 
L*.TXT is not accepted by PRINT, nor is the % wildcard accepted. 

If your filespec includes no file type, the default file type is 
.LST. 

Command Qualifiers 

/[NO] DELETE 

Specifies that files be deleted or not deleted from the directory 
after they are printed. The default is /NODELETE. 

The /[NO] DELETE qualifier to the filespec can be used to override 
this qualifier for a given file in a list of filespecs. 

/COPIES :n 

Specifies the number of copies to be printed. The default is 
/COPIES: 1. If your PRINT command includes this qualifier and 
specifies more than one file, the resulting QMG print job 
consists of the specified number of copies of the first file 
named, followed by that many copies of the second file, and so 
on. If you wish to print multiple copies of files by sets, use 
the /JOB_COUNT qualifier. See the examples. 
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The /COPIESrn qualifier to the filespec can be used to override 
this qualifier for a given file in a list of filespecs. 

/[NO] TRANSFER ; ://■'-/,' - ; ; "':/"".../ ■■■■ : ,, *" :: ' •> ■ ' '■■' ., *"';..""",. '. ■'' " ' '/"■'., " . ,..'"' " : "' ; "*,C 

Transfers spooling of ;■) file from the original device, even if 
that device Ls not public. Normally, files on nonpublic devices 
arc copied to pseudo device »sr»: before spooling. 

This switch can be overridden on the file level. The default is 
: /NOTRANSFER -- J"':;; '■* "'""^ '' \>, .,"'"" -V' '''-'j - h " %.. ''''/ "j; ;■"■'«-. ;S"*: ; ""bJ- ■»;' '" "Y ^'? 

; ^ ' : '«, * s e e ' examp'l cs . ":= " ! " i : : .■,. """ . ■■»- "\ - »: r"^ .' r \ : . > ■■" ' v ; ■':■., f ;"_• ' ; ; ,.; ■"' : '" "'.' , ^ .; ; ;/* rv '.-■"". ; ; ";*,• ""]': 

l-his qualifier is for RSX-11M-PLUS systems o»!y. 

/DEVICErddnn: 

The /DEVICE qualifier specifies that you want the file printed on 
a particular device. 

/[NO] HOLD 

The /HOLD qualifier specifies that you wish the QMG print job to 
be held in its queue until you release it. See the RELEASE/JOB 
or RELEASE/ENTRY commands in Chapter 9, or the RSX-11M/M-PLUS 
Batch and Queue Operations Manual . The default is /NOHOLD. 

/JOB_COUNT:n 

Specifies the number of sets of files you wish printed. The 
default is /JOB_COUNT: 1. If your PRINT command includes this 
qualifier and specifies more than one file, the resulting QMG 
print job consists of a set consisting of the files named in 
order, followed by another set, and so on. If you wish to print 
multiple copies of one or more files, but not in sets, use the 
/COPIES qualifier. See examples. 

/[NO] JOB_PAGE 

Specifies whether you wish a job flag page printed at the 
beginning of the QMG print job. The default is /JOB_PAGE. Use 
/NOJOB_PAGE when you are printing on special forms, or otherwise 
do not wish to include a job flag page. See the / [NO]FLAG_PAGE 
qualifier for controlling file flag pages. Figure 4-2 shows the 
difference between job flag pages and file flag pages. 

/QUEUE :queuename 

Specifies the name of the print queue in which the job is to be 
placed. The default is the PRINT queue. 

/[NO] UPPERCASE 

Specifies that the print job can be sent to a line printer 
without the lowercase character set. The default is /UPPERCASE. 



4-54 



HANDLING FILES 



PRINT (Cont.) 



01234567S901234567S9 
01234567890123456789 

01234567890123456739 
01234567890123456789 



R8X-HM-PLUS V2 ** 
RSX-11H-PI.US V2 *• 
RSX-1IM-PLUS V2 *• 
RSX-11M-PLU9 V2 •* 



n.taamzY - no page limit 25-jan-82 10129153 

FORM «0 - NORM*!. H S pQHA*£ FORMS £5-JiN-52 1B;29[?3 

NO IMPLIED FORM FEED 25-JAN-62 1B|2«|53 

Oeai[T,!BB3S2ZT.T8T;: 25-JAN-62 1B|29|53 



842345678901234567*9 
SUJj;S476?6i23434.755 
B123«56789B123«5678« 
S123456?»9B12J4*»78* 



RRRRRRRp 
RRRRRRRR 



MM WW 


RRRRRRRR 


HM HW 


RRRRRRRR 


MW HH MM 


PR RR 


MM HW WW 


RR RR 


MWNH MWWW 


RR RR 


HWMW NXNH 


RR RR 



mm 


TTTTTTTTTT 


EEEEEEEEEE 


RRRRRRRR 


nun 


TTTTTTTTTT 


EEEEEEEEEE 


RRRRRRRR 


11 


TT 


EE 


RR 1 


n 


TT 


EE 


RR 1 


11 


TT 


EE 


RR { 


11 


TT 


EE 


RR j 


11 


TT 


EEEEEEEE 


RRRRRRRR 


11 


TT 


EEEEEEEE 


RRRRRRRR 



mm 
mm 



3S3S38SS 

3SSSSS3S 



SS8S33 

ssssss 



EEEEEEEEEE 
EEEEEEEEEE 



as 
39 



35388333 
33333333 



ZZZZZZZZZZ ZZZZZZZZZZ 11 

ZZZZZZZJZZ Z222ZZZZZZ TY 

ZZ ZZ YY 

Z2 ZZ YY 



II 


22 


22 


n 


2Z 


ZZ 


:: 


ZZ 


ZZ 


niin 


1ZZZZ1IZZZ 


ZZZZZZZZZZ 


mm 


zzzzzzzzzz 


ZZZZZZZZZZ 



0123456789012J«S67S9 
0123115670901231156789 
9123US67890S23"56789 
01234567890123456789 



■ RSX-UM-PLUS V2 ** 

RSX-UW.»LU8 Y2 ** 

RSX-UN-PLUS V2 •« 

RSX-11M-PLUS V2 <•* 



[7.100JI2ZY - NO PAGE LIMIT 25-JAN-82 1B|29|53 

FORM *8 • NORMAL HARDWARE FORMS 25-JAN-82 1S|29|53 

NO IMPLIED FORM FEED 25-JAN-82 10l«9l33 

DB2lC7,t00]IZZY.mH 25-JAN-B2 ]0|29|33 



0123<|56T89B123at*789 
dt23<i5bT89BU3«567*9 
B12345b789Bi23a56789 
01234567890123456789 



0iaifl5fc7«90l23«56789 
01230567898123056789 
01234547890123456789 



r8x-hm-plus vz ** 

RSX-iiM.PLUS V2 *• 

RSX-tlM-PLUS V2 *» 



DB2l[7,i00]IZZY,TXT|l 

COPY 1 OF 1 

DELETION NOT SPECIFIED 



25-JAN-62 1B|29|S9 
25-JAN-82 10129159 
25-JAN-82 10129159 



0123456789012S456789 
01234567890123456789 
01234567890123456789 



mm 


ZZZZZZZZZZ 


ZZZZZZZZZZ 


mm 


zzzzzzzzzz 


ZZZZZZZZZZ 


11 


ZZ 


22 


n 


ZZ 


22 


11 


ZZ 


ZZ 


11 


ZZ 


ZZ 


11 


ZZ 


22 


11 


ZZ 


ZZ 


11 


ZZ 


ZZ 


11 


ZZ 


ZZ 


11 


ZZ 


ZZ 


n 


ZZ 


ZZ 


mm 


ZZZZZZZZZZ 


ZZZZZZZZZZ 


uuu 


ZZZZZZZZZZ 


ZZZZZZZZZZ 



TTTTTTTTTT 


lilt 


11 


TTTTTTTTTT 


MM 


11 


TT 


MM 


1111 


TT 


MM 


nu 


TT 




11 


TT 




11 








TT 


MM 


LI 


TT 


MM 


11 


TT 


MM 


11 


TT 


pi 


11 


TT 


M 


11 


TT 


M 


uuu 


TT 


M 


mm 



01234567890123456789 
01234567890123456789 
01230567890123456789 



R5X-11M-PLUS V2 ■ 
R8X-HM-PLUS V2 ■■ 
flSX-HH*PLUS V2 1 



OB2l[7,10BlIZZY,TXTil 

COPY I OF 1 

DELETION NOT SPECIFIEO 



2S-JAN-62 
25-JAN-82 
2S-JAN-82 



10129159 

10)29159 
10|29t59 



01234567890.23456789 
01234567890123456789 
01234567890123456789 

ZK-563-81 



Figure 4-2 Job Flag Page and File Flag Page 
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/[NO] LOWERCASE 

Specifies that the print job must be sent to a line printer 
having the lowercase character set. The default is /NOLOWERCASE. 

/PAGE_COUNT:n 

Sets a limit on the number of pages the job may produce, ranging 
from 1 through 32767. 

Without this qualifier, the number of pages is unlimited (n=0) . 

/NAME: jobname 

Specifies a name for the print job. Your job name can be nine 
alphanumeric characters. 

If you specify a job name, that name appears on the flag page at 
the beginning of the printed output. Otherwise, the file name of 
the first file is used as the job name. 

The job name also appears in the SHOW QUEUE display. The job 
name includes the UIC under which it was entered. 

There can be more than one job of the same name, but each job has 
a unique entry number which appears in the SHOW QUEUE display. 

/PRIORITY:n 

Sets the queue priority of the print job. For nonpr ivileged 
users, n can be from through 150. Privileged users can set n 
up through 250. The default is 50. 

The Queue Manager prints the highest priority jobs first. When 
two jobs have the same priority, the job that has been in the 
queue longest is printed first. 

/FORMS :n 

Specifies the type of form on which the job must be printed. n 
can have a value from through 256. The default is 0. See your 
system manager for details on how to specify the particular forms 
used at your installation. 

/LENGTH: n 

Sets the length of a logical page; n can be any number from 
through 255. The default is n=0. If you set a length, a form 
feed is automatically generated if one is not found within n 
lines. 

When you set the length at 0, the default, the logical page 
length is unlimited. 

This qualifier has no effect on how the printer handles form-feed 
characters. A form feed still moves the printer to the top of 
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the next physical form, such as the perforation in a sheet of 
line-printer paper. This qualifier simply adds the requirement 
that the printer move to the top of the next physical page if no 
form-feed character is encountered within n lines. See the 
example using /LENGTH. 

/[NO] RESTART 

Controls requeuing of your job if it is stopped or aborted while 
being processed. 

If /RESTART is specified, your job starts again from the 
beginning if it is aborted. 

/NORESTART is the default. If the printer is stopped while your 
job is active, the job picks up where it left off when the 
printer is started. 

In neither case are you missing any of your job, but with 
/RESTART your job is all in one piece. 

If, however, the paper jams in the line printer, the operator 
must see that your job is restarted above where the jam began. 

/[NO]FLAG_PAGE 

Adds flag pages to each file in your print job. With /FLAG_PAGE, 
the number of flag pages is equal to the number of job flag pages 
that precede the job. 

With /NOFLAG_PAGE (the default) , your job is still preceded by a 
job flag page, but the files in the job are printed without any 
file flag page, separated only by form feeds. You can suppress 
the job flag page with the /NOJOB_PAGE qualifier. Figure 4-2 
shows the difference between the job flag page and the file flag 
page. 

/AFTER: (dd-mm-yy hh:mm: [ss] ) 
(mm/dd/yy hh:mm:[ss]) 

Blocks the job until after the specified time. Depending on the 
print queues at that time, your job may be run immediately, or 
later, when its turn comes up in the queue. 

The parentheses, hyphens (or slashes), colons, and the space 
between the calendar and clock fields are all necessary syntax. 
Note that a space is used only between the calendar and clock 
fields. The space is not necessary if either field is omitted. 

You can specify the calendar field in either of two formats: 

dd-mm-yy Uses a 1- or 2-digit number for the day, the first 
three letters for the month, and two numbers for the 
year. 

mm/dd/yy Uses a 1- or 2-digit number for the month, a 1- or 
2-digit number for the day, and two numbers for the 
year . 
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If you leave out the calendar field, the day defaults to the 
current date. 

yy must be between 77 and 92. If you leave it out, the year 
defaults to the current year. 

hh:mm:ss is the hour, minute, and second. 

If you leave out the clock field, the time defaults to 00:00:00 
on the given date. 

ss need not be given. It defaults to 00. In fact, you cannot 
specify ss . If you do, it is checked for syntax only. The Queue 
Manager always takes a few seconds to start the job. 

Specifying a time using /AFTER is equivalent to issuing a Print 
command at that time. The job may still have to wait in its 
queue to be printed. 

/[N0]WIDE 

The /WIDE qualifier specifies that the file must be printed on a 
processor that has been initialized /WIDE. The default is 
/NOWIDE. 

File Qualifiers 

These qualifiers are used to override the corresponding command 
qualifiers when you have given multiple filespecs as parameters 
to the PRINT command. 

/COPIES :n 

Overrides the /COPIES command qualifier when attached to a 
particular filespec. 

/[NO]DELETE 

Overrides the /[NO] DELETE command qualifier when attached to a 
particular filespec. 

/[NO] TRANSFER 

Ovt-tr I'J^-j thfc? /[NO] TRANS PER command qualifier when attached to a 
particular filespec ON KSX-11M-PLUS Systems. 

Examples 

>PRINT 

File(s)? PASHA.CMD 

PRI — Job 305r riaiiia "PASHA "» submitted to Queue 'PRINT ' 

This example prints the most recent version of PASHA.CMD from the 
default device and UFD on the line printer. The Queue Manager 
returns a message confirming that the job has been submitted and 
giving an entry number. You can use this entry number in QMG 
commands. See Chapter 9, and also the RSX-11M/M-PLUS Batch and 
Queue Operations Manual. 
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>PRINT/C0PIESt20 

File(s)? PASHA. CHD 

PRI — Job 706» name "PASHA "i submitted to Queue "PRINT " 

This example prints 20 copies of PASHA.CMD. They are printed 
end-to-end with no flag page except at the beginning. 

>PR I /COP J20/FL AG-PAGE PASHA.CMD 

PRI — Job 321j nsme "PASHA "? submitted to ausus "PRINT " 

This example prints 20 copies of PASHA.CMD, each with a flag 
page. 



>PRIN/C0PIESJ2 DAVID.TXT, DAN, TXT 

F'RI — Job 18» name "DAVID "» submitted to Queue "PRINT " 

This example prints two copies of DAVID.TXT followed by two 
copies of DAN. TXT. It does not print two sets of one copy of 
each file. If you wish to print sets of files, see the next 
example. 



>PRINT/J0B_C0UNT:2 DAVID, TXT. DAN, TXT 

PRI — JOB 311 r NAME "DAVID '» submitted to Queue "PRINT " 

This example prints a set consisting of a copy of DAVID.TXT 
followed by a copy of DAN. TXT, and then prints another set of 
DAVID.TXT followed by DAN. TXT. 



>PRI/FLAG PASHA. CMDf RAJAH.CMD. SHEIK, CMfl 

PRI -- Job 99?r name "PASHA ', submitted to Queue "PRINT " 

This example prints one copy of each file, each with its own flag 
page. 

>PRI/NAME!ARABY/FLAG PASHA. CMHj RAJAH, CMO. SHEIK.CMD 

PRI -- JOB 805» NAME "ARABY "> submitted to cueue "PRINT • 

This example prints one copy of each file, each with its own flag 
page, and gives the name ARABY to the job as a whole. The name 
ARABY appears in the print queue and at the head of the entire 
printed output. 



>PRINT/LENGTH X 60 GLADRAG . MAC 

PRI --- Job 22r name "GLADRAG "? submitted to a.eue "PRINT " 

This example prints a single copy of the file GLADRAG. MAC. This 
is a source program file without form-feed characters in it. The 
user wants to print it on line-printer paper, a physical form 66 
lines long. To avoid printing over the perforations, the user 
has specified a logical length of 60 lines. Each time 60 lines 
have been printed, the logical page is complete and the printer 
moves to the top of the next physical page. 
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If the file had form feeds in it, the printer would move to the 
top of a physical page each time it encountered a form feed and 
each time it printed 60 lines without encountering a form feed. 

>PRI/C0PIES{20 MOB. COR, RIFRAF.COR, RABBLE. .COR/COP ! 19 j PROLE. COR 
PRI — Job 77> name "MOB "» submitted to Queue 'PRINT " 

This example prints 20 copies each of MOB. COR, and RIFRAF.COR, 19 
copies of RABBLE. COR, and then 20 copies of PROLE. COR. 

>PRI/DELETE LASER. TSTj PHASER. TSTf RAZOR . TST/NOBELE 

PRI — Job 406t nsme "LASER "» submitted to aueue "PRINT " 

This example prints the three files and deletes the first two 
from the current UFD. 

Only the versions specified in the PRINT command are deleted, in 
this case, the most recent versions of LASER. TST and PHASER. TST. 

>PRI/AFTERJ (4-JUL-82 13: 13) CONST, CON 

PRI — Job 809> name "CONST "> submitted to (aueue "PRINT " 

This example blocks the job in its queue until the specified date 
and time. The file itself remains in its UFD. Deleting the file 
from its UFD does not take it out of the queue, but does prevent 

i f- from h(=irin orint^d- 



>PRI/AFTER: (17100) GUNGA.DIN 

PRI — Job 765r nsme "G'JNGA "r submitted to oueue "PRINT " 

This example prints the file after 5 P.M. on the day the command 
is entered. If the command is entered after the specified time, 
the file is printed immediately. 

Notes 

P is the short form of PRINT. 

The PRINT command does not accept the "%" wildcard. The "*" 
wildcard can only be used to substitute for a complete part of 
the filespec and NOT for part of a file name or file type as the 
PIP-related commands do. 

For more information on the PRINT command, see the RSX-11M/M-PLUS 
Batch and Queue Operations Manual . This manual also includes a 
description of the SHOW QUEUE command, which displays information 
about print jobs in queues. 

PRINT is to print jobs as SUBMIT is to batch jobs. The PRINT 
command defines QMG print jobs. 

Once your job is in a queue, you can modify some job attributes 
with SET QUEUE. See the RSX-11M/M-PLUS Batch and Queue 
Operations Manual . 

The Queue Manager automatically deletes .PMT and .DMP files after 
they are printed. 
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The /LOWERCASE and /UPPERCASE qualifiers have no effect on the 
nature of your output. They do not cause your job to be printed 
all uppercase or in lowercase. Rather, these qualifiers must 
match the attributes given to the printer when it was 
initialized. A printer without the lowercase character set can 
be initialized /LOWERCASE and accept print jobs with the 
/LOWERCASE qualifier on the PRINT command. This might be done if 
a printer with the lowercase character set was temporarily 
unavailable. In most cases, only printers with the lowercase 
character set are initialized /LOWERCASE, however. 

Despite your setting of the /[NO] RESTART qualifier, your job may 
be restarted by commands to the Queue Manager from your system 
manager. See your system manager if you have jobs where 
restarting or not restarting may be a problem. 

If you use the /NQTRANSFER qualifier, you must leave the volume 
mounted until the print job is Finished. Under the :!e fault 
/NOTRANSFER your riles ^.z<~ copied to another location and the 
volume can be dismounted. If you do not. wish your files to be 
accessible to other systen users, use the /KOTKANSFER qualifier. 
This qualifier is not recommended when the original device is 
slow,, such as DHCtapes , cassettes, or floppy disks. Oh the other 
hand,- if there is no space on the psaudo device SP: (usually the 
system disk), you can use the /NOTRANSFKR qualifier rather than 
waiting for. space on SP: . v™-* •'^V^"'™:!,.,. ' ,: '■ ; - ; *-' ':.,." : "';.,./' ! """ :' '■■■■>■'' ■ ",,,',„' ; 4 y ; "'- : 

The flag pages and the job pages have different formats for the 
banner text. The job name page shows the UIC the PRINT command 
was issued under on the first line and a 9-character job name 
(derived from an explicit job name or the file name of the first 
file in the job) on the second line. The flag page shows the 
full 9-character file name on the first line and the file type 
and version number on the second line. See Figure 4-2. 

Entry numbers run from 1 through 999 and are unique. Various QMG 
commands permit you to identify your job either by this number or 
by job name. The job name includes your UIC. See Chapter 9 and 
also the RSX-11M/M-PLUS Batch and Queue Operations Manual. 



4.4.3 APPEND 

APPEND appends to an existing sequential file records from one or more 
sequential files. 



Format 



APPEND [/qualifiers] ] 
File(s)? infile[s] 
To? outfile 

APPEND[/qualifier[s] ] infile[s] outfile 
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Command Qualifiers 

/DATE : dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SI NCE:dd-mmm-yy/THROUGH: dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 

Parameters 

inf ile[s] 

Specifies the file or files to be appended to the output file. 
You can use APPEND only on sequential files. 

outfile 

Specifies the file to which the input files are appended. 

The output file must be an existing sequential file. The output 
file has the same version number after the APPEND command is 
executed as it had before the command was issued. The input 
files appear at the end of the output file in the order they were 
specified . 

No wildcards are permitted in output file specifications. 

There are no qualifiers for the out nut filespec;. 

Although the output file must exist, it may be an empty file. 

Command Qualifiers 

/DATE: dd-mmm-yy 

The /DATE qualifier specifies that you wish the APPEND command to 
affect only files created on the date given. 

/SINCE: dd-mmm-yy 

The /SINCE qualifier specifies that you wish the APPEND command 
to affect only files created on or since the date given. 

/THROUGH : dd-mmm-yy 

The /THROUGH qualifier specifies that you wish the APPEND command 
to affect only files created on or before the date given. 

/SINCE :dd-mmm-yy/THROUGH:dd-mmm-yy 

The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the APPEND command to affect only files created 
within that range. 



/TODAY 



The /TODAY qualifier specifies that you wish the APPEND command 

to affect cr.ly files created on the same day the command is being 
issued. 
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/EXCLUDE : f i lespec 

The /EXCLUDE qualifier specifies that you wish the APPEND command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 

Examples 

> APPEND 

File(s)? BIRD.DOGJ* 

To? JOKER.TXT 

This example appends copies of all versions of BIRD. DOG in order 
to the end of the most recent version of JOKER.TXT. 

>APPEND *.LST LIST.FIL. 

Appends copies of most recent versions of all files of the type 
•LST to LIST.FIL. Appended files appear in the order they are 
listed in the directory. 



Notes 



APPEND does not delete the input files. They remain intact. 
Copies of the input files are placed at the end of the output 
file. 



4.4.4 SORT 

SORT invokes the unbundled SORT-11 utility. If your system includes 
SORT-11, the SORT command allows you to read an input file, sort the 
contents, and write out the sorted data to an output file. The 
sorting sequence is determined by control fields called key fields 
within the data. 



Format 



SORT/KEYS: (abm.n[:abm.n...]) [/qualifiers] inf ile[/FORMAT:arg] [/qualif ier [ s] ] outf ile[/qualif ier [s] ] 

Command Qualifiers 

/ALLOCATION :n 

/BLOCKSIZEm 

/BUCKETSIZE:n 

/[NO] CONTIGUOUS 

/DEVICE-.ddnn: 

/WORK_FILES:n 

/FORMAT: fmt[:n] 

/PROCESS: type 

/SIZE:n 

/SPECIFICATION: filespec 
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File Qualifiers 

/FORMAT :fmt:n 
/INDEXED:n 
/RELATIVE 
/SEQUENTIAL 

Format Arguments 

FlXED:n 
STREAM: n 

vjvtlS.L'iKjrvLi • u 

VARIABLE :n 
Parameter 
inf ile 

Specifies the file you wish to sort. The file must be in a valid 
RMS-11 format. The default file type for input files is .DAT. 

outf ile 

Specifies the file where you wish the sorted output written. 

Command Qualifiers 

/KEYS: (abm.n) 

Specifies the keys on which the sorting is to be based. This 
determines the sequence in the output file. You must enclose the 
argument to /KEYS in parentheses. For defaults, see the first 
two examples. 



abm. n 



Specifies the key field. You can specify up to 10 key 
fields, separated by colons, such as the following: 

/KEYS: (BN1.6:C8.2) 

The default is /KEYS: (CN1.9) . See the examples. 

a Describes the data in the file and thus how it is to be 
handled. If the character is omitted, the default 
value is C. The possible values are as follows: 

B, C, D, F, I, J, K, P, Z 

The meaning of each of these characters is described 
under Data Description Characters. 

b Defines the general sort order. The possible values 
are: 

N Ascending order (the default) 
Opposite, or descending, order 
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m A decimal number giving the first byte of the key field 
starting from 1. This number must be explicitly 
stated. 

n A decimal number giving the length of the key field in 
bytes. This number must be explicitly stated. 

Data Description Characters 

B Two's complement binary. 

C Alphanumeric. 

D If the characters are alphabetic, numeric with the sign 
superimposed over the units digit, or contain slashes (/) , 
use the value of the digits group. For example: 

A2CD5 = (+) 12345 and A/47J = {-) 11471 

If the characters represent a standard FORTRAN-IV number, 
such as 12, -35, 42.98, or -0.76E+3, convert the number to 
binary for storage or evaluation. 

F 2- or 4-word floating point binary. 

I Same as D, but with the sign leading and separate, so that 
the first byte of the field is a + or -. 

J Same as I but with the sign trailing and separate. 

K Same as D but with the sign leading and overpunched (54321, 
for instance if positive, would come out as 5432A. the 
negative of 54321 would be 5432J) . 

P Packed decimal format. 

Z ASCII zone. 

/ALLOCATION :n 

Specifies the initial space allocation for the output file. 
Legal values range from through 65,535. If you do not use this 
qualifier, the output file allocation defaults to the input file 
size for the record and tag sort processes. For index and 
address routing sort processes, the default size is based on the 
number of records sorted. 

/BLOCKSIZE:n 

This qualifier is valid for magnetic tapes only and is used to 
specify a nonstandard magtape block size. If this qualifier is 
not used, the block size defaults to the standard 512-byte block. 



4-65 



HANDLING FILES 



SORT (Cont.) 



/BUCKETSIZE:n 

Specifies the RMS-11 bucket size (the number of 512-byte blocks 
per bucket). Please note that the size of the block is the 
standard 512 bytes even if the /BLOCKSIZE qualifier is used. The 
default value of this qualifier depends on the organization of 
the input file. If the input and output files are of the same 
organization, the default for the output file is the input file 
value. If the input files differ in organization or the default 
is required for the input file, the default value is 1. 

/[NO] CONTIGUOUS 

Specifies that the output file be contiguous. This means that 

each block in the file will be physically located between its 

logical predecessor and its logical successor with no filler or 

extraneous material separating blocks. The default is 
/NOCONTIGUOUS. 

/DEVICE:ddn: 

Specifies the device on which you want the scratch files. This 
qualifier overrides any device specification from Task Builder 
options . 

/WORK_FILES:n 

Specifies the maximum number of intermediate scratch files. 
Legal values are from 3 through 8. The default value is 5. 

/SPECIFICATION: filespec 

Specifies the name of a file containing SORT-11 controls for the 
kind of sorting process to be used. 

/PROCESS: arg 

RECORD 

TAG 

ADDRESS_ROUTING 

INDEX 

Specifies the type of sorting process to be used. The default is 
RECORD. 



/RELATIVE 



Specifies that the output file is to have relative file 
organization. 



/SEQUENTIAL 



Specifies that the output file is to have sequential file 
organization. 
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/SIZE:n 

Specifies the size of the retrieval window. The ranges and 
defaults for this qualifier are determined by the operating 
system. See your system manager for further information. 

File Qualifiers 

/FORMAT: arg 

FIXED:n 
STREAM: n 
VARIABLES 
UNKNOWN : n 

Specifies the record format and the maximum size (n) in a file. 
The maximum record size n is the exact record size in bytes for 
FIXED length records. For other formats, n is the size in bytes 
of the largest record present. You must specify a value for n 

for input files. 

The default is /FORMAT: FIXED: 84 . 

This file qualifier specifying the format of input records can be 
overridden by the corresponding file qualifier for output files. 

/INDEXED:n 

Specifies that the input file has the indexed sequential file 
organization. n specifies the number of keys. There is no 
default for n. 



es 








>CREATE 


PHONE, 


>TXT 




BAKER 








FOX 








EASY 








CHARLIE 








ABLE 








DO 6 








gfRL/z) 








>S0RT 








Input, fi 


Lie? PHONE. 


TX 



Output file? PHONE, OUT 

SRT -- mi ELAPSED REAL T IME '. 00 ! 00 J 04 

SRT -- mi TOTAL RECORDS SORTED 6 

>TYPE PHONE. OUT 

ABLE 

BAKER 

CHARLIE 

DOG 

EASY 

FOX 
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This example illustrates the defaults for the DCL SORT command. 
The user created a file where no record (line) is longer than 80 
characters. SORT-11 sorted the file on the basis of the first 
nine characters. This sorting is in ASCII sequence, meaning that 
symbols are sorted first, followed by numbers, followed by 
uppercase letters, followed by lowercase letters. 



>S0RT/KEYS: (CN1.9) PHONE . TXT/FORMAT I F IXED t 84 PHONE. OUT 

This example is the equivalent of the previous one, with defaults 
explicitly stated. SORT-11 itself has no defaults for these 
values. The defaults come from DCL. 



>DIRECT0RY SLMINDEX. FIL 



DIRECTORY DB1 I [303 , 53 
9-AUG-82 li:40 

SLHINDEX.FIL.il 69. 09-AUG-82 11:00 

TOTAL OF 69. /69. BLOCKS IN 1. FILE 

> SORT/KEY !(CN1. 9) /DEV ! DBO : /FILE ! 3/SEQ/PROC ! REC SLMINDEX . F Il/FOR : UAR! 100 SLMINDEX . TST 
SRT — MJELAPSED REAL TIME: 00!00!30 
SRT — HiTOTAL RECORDS SORTED*. 1410 

>DIRECT0RY SLMINDEX.* 

DIRECTORY DBliC303fS3 
9-AUG-82 11J41 

SLMINDEX. FILS1 69. 09-AUG-82 U!00 
SLHINDEX.TSTil 68. 09-AUG-82 11141 

TOTAL OF 137. /138. BLOCKS IN 2. FILES 

In this example, the user started out with a file SLMINDEX. FIL, a 
variable format file with the largest record size 100 bytes. The 
key field is specifed as CN1.9. The C indicates the file is to 
be sorted as an alphanumeric file. The N specifies ascending 
order. The 1 indicates that the sort is to start on the first 
byte of each record and the 9 indicates that the sort is to 
continue through the ninth byte of each record. The command 
directs that three scratch files be created on DBO: and then 
deleted after the operation completes. The output file is 
requested to be sequential and the sort is specified as a record 
sort. 
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In other words, the file is a sequential file containing numbers 
and letters with up through 100 characters per record (line) . 
The user wishes these records sorted on the basis of the first 9 
characters in each record with the resulting sort in ascending 
order, with the lower ASCII values first and the higher ASCII 
values following. Note that while the ASCII values go up as you 
go through the alphabet, all lowercase letters have higher values 
than any uppercase letter. Furthermore, characters such as 
blanks, tabs, bells, and the like have the lowest ASCII values. 

Notice the messages informing you of the time elapsed from the 
time you entered the command until the sort completed and of the 
number of records sorted. 



Notes 



SORT-11 is an unbundled product that is not available on all 
systems. The SORT command depends on the presence of SORT-11. 
The file SORT.TSK should be located in the system directory on 
RSX-11M or the library directory on RSX-11M-PLUS. 

Thus, you can also invoke SORT-11 with the command 

>RUN $SORT 

If you run SORT-11, you must enter commands in the SORT-11 
format, not the DCL format. 

You cannot use the SORT command without an understanding of 
SORT-11. See the PDP-11 SORT Reference Manual. 



4.4.5 DIFFERENCES 

DIFFERENCES compares two ASCII (text) files line by line to determine 
if parallel records (lines) are identical, and produces a listing of 
the differences between the files, if any. 

Format 

DIFFERENCES [/qualifier [s] ] 
Filespecl? infilel 
Filespec2? infile2 

DIFFERENCES [/qualifier [s] ] infilel infile2 

Command Qualifiers 

/CHANGE_BAR[:n] 
/IGNORE: (arg[,s] ) 

BLANK_LINES 

COMMENTS 

FORM_FEEDS 

SPACING 

TRAILING_BLANKS 
/LINES:n 
/NONUMBERS 
/OUTPUT : f i lespec 
/SLP[:au] 
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Parameters 

inf ilel 



Specifies the first of two files to be compared. The file name 
must be included. The default file type is .MAC. 

inf ile2 

Specifies the second of two files to be compared. The file name 
must be included. The default file type is .MAC 

Command Qualifiers 

/CHANGE_BAR[:nnn] 

Specifies that the output consists of a listing of infile2 with 
change bars applied to each line in infile2 that does not have a 
corresponding line in inf ilel. The nnn argument is the number of 
the ASCII character to be used for the change bar. The default 
is 041, the exclamation point {!). Here are the codes for some 
commonly used ASCII characters: 



1 


041 


# 


043 


$ 


044 


* 


052 


+ 


053 


< 


074 


> 


076 


■p 


077 


i 


074 


/IGNORE: (arg[, 


s]) 


BLANK 


; LINES 


COMMENTS 


FORM 


FEEDS 


SPACING 


TRAILING BLANKS 



Specifies that you wish certain defaults to be ignored in making 
the comparison. Without the /IGNORE qualifier, the comparison is 
strictly line-by-line. If you specify only one argument, you do 
not need the parentheses. If you specify more than one argument, 
enclose them in parentheses and separate them with commas (,). 

The default is to include all these factors in the comparison. 

The BLANK_LINES argument specifies that blank lines are to be 
excluded from comparison. The default is to include blank lines 
in the comparison. 

The COMMENTS argument specifies that comments, that is, text 
preceded by a semicolon (;) not be included in the comparison. 
Otherwise, comments are compared like all other text. 
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The FORM_FEEDS argument specifies that lines beginning with a 

single form-feed character (CTRL/L) are to be excluded from the 

comparison. The default is to include such lines in the 
comparison . 

The SPACING argument specifies that any sequence of blank and tab 
characters is to be interpreted as a single blank for the 
comparison. This argument is useful when comparing source files 
that differ only in their spacing. The output listing includes 
blanks and tabs as they are found in the input files, but the 
blanks and tabs are ignored. The default is to compare sequences 
of blanks and tabs like any other characters. 

The TRAILINGJBLANKS argument specifies that all blanks following 
the last nonblank character in the line be ignored in the 
comparison. The default is to compare trailing blanks like all 
other characters. If you specify both TRAILING_BLANKS and 
COMMENTS in your /IGNORE qualifier, any blanks preceding a 
semicolon (;) are also ignored. 

The DCL DIFFERENCES command does not have quite the same defaults 
as CMP, the File Compare Utility, which DIFFERENCES invokes. 
Specify /IGNORE: (BLANK_LINES,FORM_FEEDS) to duplicate the CMP 
defaults for blank lines and form feeds. Other CMP defaults need 
not be specified. 



/LINESrn 



Specifies that n lines must be identical before a match is 
recognized. The default value for n is 3 identical lines. 

/[NO] NUMBERS 

/NONUMBERS specifies that lines in the output file not be 
preceded by line numbers. The standard output listing 
automatically includes line numbers. Line numbers start with 1 
in increments of one. All lines are numbered, including blanks. 

/OUTPUT:filespec 

Specifies that the output listing be written to the file named in 
the qualifier. Normally, this output appears on your terminal. 

/SLP[ :au] 

Specifies that the output listing take the form of a SLP indirect 
command file. When you include this qualifier, the output 
listing is an SLP indirect command file that makes infilel 
identical to infile2. The optional au argument, preceded by a 
colon, is a 1- through 8-character alphanumeric audit trail 
symbol. For more information on the Source Language Input 
Program (SLP) , see Chapter 13 of the RSX-11M/M-PLUS Utilities 
Manual. 
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Examples 



The following examples use several slightly different versions 
the same MACRO-11 source file for comparisons. The full text of 
version 1 is printed here. Version 2 is identical except 
that one Executive directive is different; version 3 
additional blank lines inserted. In each instance, the "IDENT" 
number matches the version number. 



of 



for 
has 



Here is the text of version 1: 



.TITLE WRITE PRINT A PREDEFINED MESSAGE ON THE USER TERMINAL 

.IDENT "01" 

.MCALL ALUN$C, QIOW$C, EXST$C 

STRING: .ASCII "This is a simple MACRO-11 program." 

LENGTH = .-STRING ; CALCULATE THE STRING LENGTH 
.EVEN 

START: ALUN$C 1,TI,0 ; ASSIGN THE LDN TO USE TO THE TERMINAL 

QIOW$C IO.WVB,l,l, , , , STRING, LENGTH, 40> 

; PRINT THE STRING 

EXST$C EX$SUC ; SUCCESSFUL EXIT IN ALL CASES 



.END START 



SETUP THE STARTING ADDRESS 



In the following examples, a "difference" as defined by the 
DIFFERENCES command, consists of one or more lines that differ in 
the two files being compared. Each "difference" ends when the 
first matching line is encountered. The listing of the 
"difference" includes all the nonmatching lines AND the first 
matching line. 

> DIFFERENCES/ IGNORE! (BLANK. LINES* FORM. FEEDS) 
Filespeci? T0M.MACS1 
Filespec2? TOM. MACS 2 

*J. ^t/ ^ ^ ^If ^ |1, s£* ^i 'Ar ^ ^ vL- *Af J, tI, Jj- i±| -^ ^i- <±r -^ -dj 'Mr T^ -At llf •& "i" 'if lit ^r "i "i "^ "i Jf ^ "A* "A' *&J ^ li/ *&* ^V ^Af ^f "if ^' 

1) DB2:t303fSDT0M,MACSi 

2 -IDENT ■ 01" 

4 , MCALL ALUN*Ct QI0W*C, EXST*C 

6 STRING: .ASCII "This is a simple MACR0--11 proSrsn." 

2) DB2:C303»5DT0M.MACS2 

2 .IDENT "02" 

4 .MCALL ALUN*C, GI0W$C> EXST$S 

6 STRING? .ASCII "This is 3 simple MACRO-li program." 
i differences found 
Ti:/-BL/-FF/-CB=T0M.MAC?lfT0M,MAC?2 

In this example, the user compared two files that differ only in 
one Executive directive — EXST$S or EXST$C — and in their 
version numbers. The user specified 

/IGNORE: (BLANK_LINES ,FORM_FEEDS) 

so as to reproduce the defaults of CMP, the File Compare utility, 
which the DIFFERENCES command invokes. 
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The listing of differences between the two files starts with the 
IDENT numbers on line 2 of the files. The next line is blank in 
both files. Although the line is numbered, it is not printed on 
the terminal and is ignored in the comparison. It would not 
change the results if one file had the blank line there and one 
did not. 

The next listed difference is in the Executive calls on line 4. 
Again, the blank lines are not shown. The next line of code 
listed is the same in both files. This marks the end of a group 
of lines that are different in the two files. 

The command line reprinted at the bottom of the listing is the 
CMP command line equivalent to the DIFFERENCES command. 

"•DIFFERENCES T0H.MACJ1 TOM, MAC 5 2 

*************** jfc************ ********************** 

1) DB2tC303»5:T0H.MACf 1 

2 .IDENT "01 ■ 

3 

4 .MCALL ALUNfCj GI0W*C» EXSTfC 

cr 
■J 

2) DB2{C303»53T0M.MACJ2 

2 , IDENT "02" 

3 

4 .MCALL ALUN*C; GIGU*C> EXST$S 

5 

1 differences found 
Ti:/BI_/FF/-CB = TOM.MAC5 1,TOM,MACJ2 

This example illustrates the defaults for the DIFFERENCES 
command. The results are the same, but the blank lines are 
printed. If one file had had more blank lines than the other, 
the results would not have been the same. See the examples 
comparing version 1 and version 3. 

>BIFFERENCES/CHANGE_BAR/IGNORE: (BLANK-LINES. FORMFEEDS) T0M.MACS1 T0M.MAC.2 

1 .TITLE WRITE PRINT A PREDEFINED MESSAGE ON THE USER TERMINAL 

2 ! .IDENT "02" 

4 ! .HCALL ALUNtC, QIQWtC, EXSTtS 

* '■ STRING! .ASCII 'This is a simple MACR0-11 program." 

7 LENGTH = .-STRING i CALCULATE THE STRING LENGTH 

8 .EVEN 

10 start: alun*c i.ti.o ; assign the lun to use the terminal 

11 qi0w$c 10. wvb, 1,1,,, .string, length. 40> 

12 ! DDTUT Tlir fiTBTtm 

» rpij.ni inc. oirvinu 

13 EXSTtC EX*SUC ! SUCCESSFUL EXIT IN ALL CASES 
15 -END START j SETUP THE STARTING ADDRESS 

1 differences found 
TI J /-BL/-FF/CB/MB f.OAl =T0M . MAC > 1 , TOM . MAC ! 2 
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This example shows the effect of the /CHANGE_BAR qualifier. The 
second file is printed on the terminal with exclamation points 
next to the numbers of the changed lines. 



>DIFFERENCES/IGNOREJ (BLANK-LINES) TOM.MACfl T0M.HACJ3 

^ ^ Jp. ^L ^. jfi ^L ^L ^ ^ ^ J^ ^L ^ ^L ^ ^ ^ ^ ^ ^ ^ ^ j^H ^i ^fc J^v ^l^ki^^l^hjfl^^ J^ jjk jfl ^ JJL ^ ifb j^l ^ ^ ^t ^l J^L f^ 

1) DB2:C303,S3T0M.MAC»i 

2 .IDENT "01" 

4 .HCALL A'LUN*Cf QI0U*C» EXST*C 

2) DB2!C 303,5 3 TOM. MAC! 3 

2 * lEiENT " 03 " 

A .MCALL ALUN*C, QI0U*C7 EXST$C 

1 differences found 
TI*./-BL/FF/-CB=TOM.MAC»l»TOH.HACf 3 

Versions 1 and 3 differ only in their blank lines and version 
numbers. In this example, with /IGNORE: (BLANK_LINES) , the only 
difference is in the IDENT numbers. The listing of the 
difference ends with the first line that is not different. Blank 
lines are numbered but otherwise ignored. 



>IUFFERENCE TOM.MACrl T0M.MACJ3 
******************************* ****** ************* 

1) DB2:C303»53TOM.HACf 1 

2 .IDENT "01 1 

3 

2) nB2!C303,5]T0M.MAC;3 

2 .IDENT '03" 
3 

************************************************** 

1) DB2tC303r5DT0M.HAC;i 

7 LENGTH = , -STRING i CALCULATE THE STRING LENGTH 
*************** 

2) DB2:C303»5:T0M.HAC»3 
7 

8 LENGTH = .-STRING J CALCULATE THE STRING LENGTH 
************************************************** 

1) DB2!C303i53T0H.MACfl 

11 QI0U*CI0.UVBf If l»»i f STRING t LENGTH, 40> 
*************** 

2> DB2JC303,5aT0H,WACr3 

12 

13 QIOUtCIO.UVB.1.1. r , ,STRINGfLENGTHf40> 

3 differences found 

ti:/bl/ff/-cb=tom.mac;1tToh.hac!3 

Comparing the same two files without specifying 
/IGNORE: (BLANK_LINES) has quite different results. Three 
differences are found. The first is the differing IDENT numbers. 
The other two differences are nothing more than blank lines. 
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Notes 



You can compare any two text files. They need not be MACRO-11 
source files, but most qualifiers to DIFFERENCE are for use with 
MACRO-11 files. 

The DIFFERENCES command invokes CMP, the File Compare Utility. 
See Chapter 12 of the RSX-11M/M-PLUS Utilities Manual. 



4.4.6 UNLOCK 

UNLOCK unlocks locked files. Locked files are files that have been 
improperly closed because a task aborted or stopped execution while 
the file was open. Locked files are identified by an L in the 
directory listing. 

Format 

UNLOCK[/qualifier [s] ] 
File(s)? filespec[s] 

UNLOCK[/qualifier[s] ] filespecfsj 

Command Qualifiers 

/DATE:dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 

Parameter 

filespec 

Identifies the locked file(s) that you wish to unlock. 

Command Qualifiers 

/DATE: dd-mmm-yy 

The /DATE qualifier specifies that you wish the UNLOCK command to 
affect only files created on the date given. 

,/S I NCE : dd-mmm-yy 

The /SINCE qualifier specifies that you wish the UNLOCK command 
to affect only files created on or since the date given. 

/THROUGH: dd-mmm-yy 

The /THROUGH qualifier specifies that you wish the UNLOCK command 
to affect only files created on or before the date given. 
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/SINCE :dd-mmm-yy/THROUGH:dd-mmm-yy 

The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the UNLOCK command to affect only files created 
within that range. 



/TODAY 



The /TODAY qualifier specifies that you wish the UNLOCK command 
to affect only files created on the same day the command is being 
issued. 



/EXCLUDE :f ilespec 

The /EXCLUDE qualifier specifies that you wish the UNLOCK command 
not to affect certain files. The f ilespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 



Example 



>Di rectory TOPEKA.KAN 
Directory DB0tC303f53 
2-N0v-82 13t 13 

TOPEKA.KAN S3 32, L 
Total of 32. /40. blocks in 1 



25--N0V-B2 
files 



12129 



XJNLOCK TOPEKA.KAN 



^DIRECTORY TOPEKA.KAN 
Directory HBO IE 303 , 51 
2-N0V-B2 13t 14 

TOPEKA.KAN53 32. 



25-NQV-82 1212? 



Total of 32. /40. blocks in 1. files 

In this example, the user found a locked file, perhaps through an 
error message stating that the file could not be opened. The 
locked state is indicated by the L in the third column of the 
directory listing. After the user issues the UNLOCK command, the 
file is no longer locked. 



Notes 



In many cases, a locked file has no contents because the task 
that opened the file aborted before writing to the file. In this 
case, you do not need to unlock the file before deleting it. 

Another common case of file locking is a data file that has been 
opened by some task that aborted or exited without closing the 
file. In this case, you have to unlock the data file before 
running the task again. If the file is written to by the task, 
it may have been corrupted. 
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4.5 SET AND SHOW 

You can SET and SHOW your default device and UFD. You can SET 
PROTECTION on any file in your directory, or on a volume mounted on 
your private (allocated) device. 



4.5.1 SET DEFAULT 

SET DEFAULT establishes your default device or UFD, or both. 

Format 

SET DEFAULT [ddnn: ] [ [g ,m] ] 

Parameters 

If you issue SET DEFAULT without parameters, your default device 
and UFD return to your login defaults, if you are nonprivileged . 
Privileged users must explicitly reset their login UFD. 



ddnn: 



Specifies the name of the device you wish to be your default 
device. The device must be a Files-11 device. The device name 
can be a logical name, but the SHOW DEFAULT display names the 
physical device. 

Specifies the UFD you wish to be your default directory. 

When you change your UFD, the system checks your login UIC for 
your privilege. If you are nonprivileged, you remain 
nonprivileged even if your new default UFD has a group number of 
10 or less. 

If you are privileged, this command changes your login UIC as 
well as your default UFD, but your privileges remain the same. 
In some cases, however, privileged users may have to reset their 
UFD to a privileged group number in order to use privileged 
commands. 

Examples 

>SET DEFAULT UK 1 ! C 303 » 5 3 

This example sets DK1: as the default device and [303,5] as the 
default directory. All subsequent commands default to this 
device and directory unless you explicitly state otherwise. 
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>SHOW DEFAULT 

DBltC303f53 TT56! 

>SET DEFAULT DB2 X E200 ; 200 J 

>SH0 DEF 

DB2tC200»200"J 

>SET DEF 

>SH0 DEF 

DB1JC303j53 

This example illustrates the use of the unadorned SET DEFAULT 
command. The user started with the login default device of DB1: 
and the UFD [303,5] , as given in the display from the SHOW 
DEFAULT command. Then, the user set the defaults to 
DB2: [200,200] and checked the setting with SHOW DEFAULT. 
Finally, the user issued SET DEFAULT without specifying any 
parameter. The user's defaults are returned to the login 
defaults. See notes. 



>SET DEF DKI J 

> ASSIGN DKi J SYOt 

The two commands in this example are equivalent. In each case, 
the default device becomes DKI:. When you set the default 
device, SET DEFAULT actually assigns SY0: as a logical name for 
the device you wish. SY0: is the logical device name that 
represents your default device. 



Notes 



SET DEFAULT is an unusual command in that it has differing 
effects depending on the presence or absence of its parameters. 

The only way to change your default UFD in DCL is through SET 
DEFAULT. When you issue SET DEFAULT including a UFD, DCL 
directly alters the default UFD held in your Unit Control Block 
(UCB) . 

When you change your default device, however, SET DEFAULT 
generates the equivalent of an assignment of the logical name 
SY0: to the physical device you name, as shown in the examples. 

Conversely, when you issue the command without any parameters, 
SET DEFAULT generates the equivalent of a deassignment of the 
logical name SY0:, meaning that your default device assignment 
returns to your login SY0:, which is whatever device you log in 
to, and, for nonprivileged users resets your UFD to your login 
UFD. 

Since DCL is issuing two commands, it is possible that one may 
succeed while the other fails. 
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4.5.2 SHOW DEFAULT 

SHOW DEFAULT displays the current default device and UFD for your 
terminal. 

Format 

SHOW DEFAULT 

Examples 

>SH0W DEFAULT 
DBi:C303 f ?i3 TT56J 

This example shows the display from SHOW DEFAULT, giving the 
default device and UFD, plus the terminal name. 

>SH0W DEFAULT 
DBi:C303.53 TT56J 
>SET DEFAULT DUO ■ 
>SH0tJ DEF 
DB0:C303,5:i TT56: 
>SET DEFAULT DKi:Ll> ' .1 
>SH0W DEF 
DKltClf7D TT56t 
> ASSIGN DT2t YY1* 
>SET DEF YY1J 
>SH0W DEF 
DT2tLl»73 TT56I 

In this example, the user first checked the defaults with SHOW 
DEFAULT, and then used SET DEFAULT to change the default device 
from DB1: to DBO:. The user checked with SHOW DEFAULT and then 
set the defaults to device DK1: and UFD [1,7]. After checking 
again, the user assigned the logical name YY1: to DT2: and set 
YY1: as the default device. Note that the subsequent SHOW 
DEFAULT display did not give the logical name YY1:, but the 
physical name DT2:. 

Notes 

See Chapter 5 for more information on logical assignment. 



4.5.3 SET PROTECTION 

SET PROTECTION establishes the protection status of files. 

Protection status determines which categories of user may access a 
file and what each kind of user may do to the file. 

Nonprivileged users can set the protection of any files in their own 
directory. 
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Privileged users can set the protection of any file. 

Format 

SET PROTECTION:code[/qualifier[s] ] filespec[s] 

SET PROTECTIONt/qualifier [s] ] 
File? filespec[s] 
Code? (code) 

SET PROTECTIONt/qualifier [s] ] filespec[s] (code) 

Command Qualifiers 

/DATE : dd-mmm-yyy 

/SINCE :dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 

Parameters 

filespec [s] 

Specifies the file or files for which protection is to be 
established. Multiple filespecs, separated by commas, and 
wildcards are permitted. All files you specify receive the 
protection status you specify. 

code or (code) 

Specifies which classes of users are permitted access to the file 
and what each class of user may do the the file. The parentheses 
are required syntax. 

There are four kinds of users: 

SYSTEM The operating system itself, and privileged 

users, those with group numbers of 10 or less 

OWNER The user having the same UIC as that the file 

was created under 

GROUP All users with the same group number as that 

the file was created under 

WORLD All other users 

There are also four kinds of access to files: 

READ The user, or the user's tasks, may read, copy, 

print, type the file, or run it, if it is a 
task image 

WRITE The user, or the user's tasks, may add new 

data to the file by writing to it 
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EXTEND The user, or the user's tasks, may increase 

the amount of disk space allocated to the file 

DELETE The user, or the user's tasks, may delete the 

file 

These forms of access are hierarchical, If you specify DELETE 
access, you are also granting READ, WRITE, and EXTEND access. If 
you specify WRITE access, you are also granting READ access but 
denying EXTEND and DELETE access, and so forth. 

The system default protection code is expressed as follows: 

(SYSTEM: RWED, OWNER: RWED, GROUP: RWED, WORLD: R) 

Under this code, the system, and privileged users, have full 
access to your files, You, as well as others with your group 
number, also have full access to your files. Other nonprivileged 
users can only read your files. If no other protection is 
specified, all files have this protection. In addition to the 
system default protection, there is default volume protection. 
See Section 4.1.5. 

If you wish to protect a file differently, use the same format, 
naming only the user group whose access rights you wish to change 
and the access form you wish to grant to that group. If you wish 
to deny all access to a group, simply name the group and omit the 
colon (:) and the code for the access form. 

Whenever any command specifies the protection code, enter it in 
this form. 

Command Qualifiers 

/DATE:dd-mmm-yy 

The /DATE qualifier specifies that you wish to set the protection 
only on files created on the date given. 

/SINCE:dd-mmm-yy 

The /SINCE qualifier specifies that you wish to set the 
protection only on files created on or since the date given. 

/THROUGH : dd-mmm-yy 

The /THROUGH qualifier specifies that you wish to set the 
protection only on files created on or before the date given. 

/S I NCE:dd-mmm-yy/THROUGH: dd-mmm-yy 

The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish to set the protection only on files created within 
that range. 



/TODAY 



The /TODAY qualifier specifies that you wish to set the 
protection only on files created on the same day the command is 
being issued. 
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/EXCLUDE: filespec 



The /EXCLUDE qualifier specifies that you wish the SET PROTECTION 
command not to affect certain files. The filespec argument to 
/EXCLUDE can contain wildcards, but the version number must be 
given, either explicitly or as a "*" wildcard. 



Examples 



>SET 

FUNCTION? PROTECTION 

CODE? (SYSTEM! RUED j OWNER! RUEDj GROUP, WORLD) 

>File<s>? SANTONE.TEX 

>DIRECTORY/FULL SANTONE.TEX 
Directory DB1 5 C303 r 5 I 
5-JUL-82 1054? 

SANTONE.TEXil <10?32rll> 2./5. 4-JUI-82 ?;49 

C303i5T C RUED, RUED r , 3 

Total of 2./5, blocks in 1. file 

This example sets file protection so that privileged users and 

the owner have full access to the file and all others have no 

access to the file. The DIRECTORY/FULL command displays the 
protection of files. The list is in the same order as before: 

SYSTEM, OWNER, GROUP, WORLD. The commas separate the access 

ri n hts of each touo . The commas with nothin*"* following them 

signify no access for other users with the same group number and 
no access for WORLD. 



>SET PROTECTION *.*;* (SYS: RWE,OWN: RWE,GRO: RW,WOR: RW) 

This example sets the protection for all files in the current 
default directory. No class of user can delete the files in the 
directory; other nonprivileged users cannot extend files in the 
directory. 



Notes 



Although you can protect your files against access by privileged 
users, privileged users can change the protection status of any 
file. Thus, you can prevent privileged users or the system from 
inadvertently accessing your files, but you cannot prevent them 
from changing the protection status and doing what they will with 
your files. 

Other commands accepting a protection code include INITIALIZE, 
MOUNT, and CREATE/DIRECTORY. 

If you deny READ access to a task image file, the task cannot be 
run. 
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CHAPTER 5 
HANDLING DEVICES AND VOLUMES 



Peripheral devices are the actual hardware elements that, with the 
computer, make up a computer system. In general, a peripheral device 
is anything that is not part of the CPU or main memory. 

All input to the system and output from it is handled by peripheral 
devices. One primary function of the operating system is to manage 
efficiently all the peripheral devices in the system. 

System generation informs the Executive which devices are to be 
included in your installation and describes the characteristics of 
those devices. 

In RSX-11M/M-PLUS terminology, a file is an owner-named area on a 
volume. A volume is a collection of files or data stored on a 
magnetic medium, such as a disk, DECtape, or magnetic tape. This 
medium must be physically placed on a drive and logically mounted 
before the system can access the data on the volume. 

This chapter briefly introduces the important concepts concerning 
devices and volumes. In addition, the chapter describes the DCL 
commands that deal with devices and volumes. 



5.1 DEVICES ON RSX-11M/M-PLUS SYSTEMS 

Table 5-1 lists the devices found on RSX-11M/M-PLUS systems. Each 
installation has a different mixture of physical devices. Each 
physical device has an associated hardware controller, which serves as 
an interface between the device hardware and the CPU. In addition, 
each device has a device driver, which is the software interface 
between the operating system and the device controller. 

The table also lists pseudo devices found on RSX-11M/M-PLUS systems. 
A pseudo device is an entity treated as an I/O device by the user or 
system although it is not actually any particular physical device. A 
pseudo device name is a pseudonym through which actual physical 
devices can always be reached. See Table 5-2 and Section 5.1.2.1 for 
more information on pseudo devices. 

Individual devices are identified by a two-letter mnemonic and an 
octal unit number, terminated by a colon. If you omit the unit 
number, the system defaults to unit number 0. That is, if you wish to 
specify DBO: in a command, DB: will do. 
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Table 5-1 
Devices on RSX-11M/M-PLUS Systems 



Mnemonic 



Device 



Hardware Controller 



AD* 
AF: 
AP: 
BS: 
CL: 
CO: 
CR: 
CT: 
DB: 
DD: 
DK: 
DL: 
DM: 
DP: 
DR: 

DS 
DT 
DU 
DX 
DY 
EM 
GR 
IC 
II 

IP 
IS 
LA 
LB 
LP 
LS 
LT 
LR 
MF 
MK 
MM 
MS 
MT 
NL 
PP 
PR 
RD 
SP 
SY 
TI 
TT 
UD 
VT 
WK 
XB 
XL 
XM 
XP 
XQ 
XU 

xw 



Analog-to-Digital Converter^ 

Analog-tb-Digital Converter 1 ! 

Laboi c tor r Per i pher a i Subs /« tem 1 

br07 UNIBUS Switch 2 

Console Listing Pseudo Device 

Console Output Pseudo Device 

Card Reader 

Cassette (TU60) 

RP04/05/06 disk packs 

DECtape II (TU58) 

RK05/J/P cartridge disk 

RL01/RL02 disk drives 

RK06/07 cartridge disk 

RP02/03/RPR02 disks 

RM02/03/05 disks and RM80/RP07 

fixed media 

RS03/04 fixed-head disks 

DECtape (TU56) 

RA60/80/81/RC25/RCF25/RD51/RX50 d isks 

RX01 floppy disk 

RX02 floppy disk 

Non-Rotating Electronic Memory 

Graphics Display Processor and Scope 1 

Industrial Control System^ 

Interprocessor Interface 2 

Industrial Control System 

Industrial Control Subsystem-'- 

Laboratory Peripheral Accelerator 

System Default Pseudo Device 

Line Printer 

Laboratory Subsystem! 

Parallel Communications Link 2 

Parallel Communications Link** 

TU78 magtape 

MKAll Programmable Memory Box 2 

TU45/TU16/TE16/TU77 magtapes 

TS11/TSV05 magtape 

TS03/TU10/TE10 magtapes 

Null Device 

Paper Tape Punch 

Paper Tape Reader 

Reconfiguration Driver 2 

Spooling Pseudo Device 2 

User Default Pseudo Device 

Terminal Input Pseudo Device 

Terminal 

Universal Digital Controller !■ 

Virtual Terminal 2 

Work f i le Pseudo De vi ce 

Interprocessor Linki 

Intreprocessot "iifrik ■*'''...': 

Interprocessor Link 

Synchronous Interface 1. 

Synchronous interface* 

Synchronous Interface^ 

Synchronous Interface^- 



AD01-D 

AFC 11 

AR11 

DT07 

N/A 

N/A 

CR11/CM11 

TA11 

RH11/RH70 

DL11 

RKll 

RL11/RL211 

RK611/RK711 

RP11 

RH11/RH70 

RH11/RH70/RS03/RS04 

TC11 

UDA50/RQDX1 

RX11 

RX211 

ML11 

VT11/VS60 

ICR/ICS11 

DIP-11 

IP11/IP300 

DRS/DSS11 

LPA11-K 

N/A 

LA11/LP11/LS11/LV11 

LPS11 

PCL-11B 

PCL-11B 

RH70/TM78 

MKAll 

RH11/RH70/TM02/TM03 

TS11 

TM11/TMA11/TMB11 

N/A 

PC11 

PC11/PR11 

N/A 

N/A 

N/A 

N/A 

DHll/DLll/DJll/DZll 

UDC11 

N/A 

N/A 

DA11-B 

DL11-E 

DMC11 

DP11 

DQ11 

DU11 
DUPll 



1. Indicates device on RSX-11M only. 

2. Indicates device on RSX-11M-PLUS only. 

N/A Controller not applicable to device. 
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RSX-11M/M-PLUS systems support a variety of devices. The terminal, 
line printer, disk, and tape unit are the most commonly encountered. 
The card reader and line printer are called unit record devices. 
Disks and magnetic tapes are mass-storage devices. Disks are 
random-access devices and magnetic tapes are sequential-access 
devices. Each of these device types is discussed briefly in this 
section and, if necessary, in more detail elsewhere in this chapter. 

Devices are informally identified by the two-letter mnemonic 
identifying the device driver, such as DT: for DECtape I, but you 
should remember that the driver may support more than one device. For 
instance, the DL: driver supports both RL01 and RL02 devices. 

Unit record devices operate on data one record at a time. Unit record 
devices can store only one record's worth of data at a time. For 
instance, a line printer (LP:) receives and stores characters until it 
has a full line and then prints that line. Unit record devices on 
RSX-11M/M-PLUS include the paper tape punch (PP:), paper tape reader 
(PR:), the TU60 cassette (CT:), and card reader (CR:). 

For storing large amounts of data, disks and tapes are used. These 
disks and tapes are called magnetic media. The information stored on 
these media must be arranged in formats suitable to the operating 
system and your installation's software. 

On RSX-11M/M-PLUS systems, the information contained on the magnetic 
medium is called a volume. Volumes can be of several varieties. 
Foreign volumes are those on which the data is organized along 
principles not recognized by RSX-11M/M-PLUS systems. Files-11 volumes 
are those on which the data is organized according to the normal file 
structure used by RSX-11M/M-PLUS systems. Devices that accept media 
containing Files-11 volumes are all disk devices, including floppy 
disks and disk packs (DB:, DF:, DK: , DL:, DP:, DR:, DS: , DU:, DX:, and 
DY:), the TU56 DECtape I (DT:), and the TU58 DECtape II (DD:). 
Files-11 volumes are created through the INITIALIZE command (Section 
5.8). The operating system treats all Files-11 volumes identically, 
regardless of the device or medium. 

NOTE 

DECtapes are random-access devices. 
Therefore, in this manual and other 
system documentation, the term "disk" 
includes DECtapes and the term "magnetic 
tape" excludes DECtapes. 

Files-11 volumes must be mounted (using the MOUNT command, Section 
5.6) for the system to access them. Mounting a volume brings in a 
task called an Ancillary Control Processor (ACP) , which serves as an 
interface between system and user tasks and the device driver, and 
maintains the Files-11 structure on the disk. This ACP is called 
F11ACP. 

Magnetic tapes are a sequential-access medium. Random-access media, 
such as disks, are used where speed is the most important virtue. 
Magnetic tapes are used where economy and transportability are more 
important than speed. 
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Magnetic tape volumes are of two kinds, labeled and unlabeled. 
Labeled magnetic tape volumes are accessed through the magnetic tape 
ACP (MTAACP) and conform to the American National Standard for 
Magnetic Tape Labels and File Structure for Information Exchange (ANSI 
X3. 27-1978). Labeled magnetic tapes are sometimes called Files-11 
magnetic tapes, but this is an inaccurate term; the better term is 
labeled magnetic tapes or ANSI magnetic tapes. You can create labeled 
magnetic tape volumes through the INITIALIZE command (Section 5.8). 
Unlabeled magnetic tapes are in a nonstandard format and require that 
you have special software to handle them. unlabeled tapes must be 
mounted using the /NOLABEL qualifier. 

Laboratory and industrial devices are often encountered in 
process-control environments, particularly on RSX-llM systems. These 
devices include analog-to-digital converters (AD:, AF:), the 
laboratory peripheral subsystem (AR:), the graphics display processor 
(GR:), industrial control systems (IC:, IP;, IS:), laboratory devices 
(LA:, LS:), and the universal digital controller (UD:). 

Several physical devices are used by the system in its operations. 
There are communications devices, including parallel communications 
links (LT:, LR:), interprocessor links (XB:, XL:, XM: ) , and 
synchronous interfaces (XP: , XQ: , XU:, XW: ) . There are system control 
peripherals not normally accessed by users (BS:, MK: , II:) 




Since the information in the volume must be on some medium and since 
that medium must be physically loaded on a device drive, the device 
driver mnemonic sometimes denotes the device itself and sometimes it 
denotes the volume. For instance, if you have files on a volume to 
which you wish to have private access, you take the following steps: 

1. Check with SHOW DEVICES dd : to see which devices of the type 
you wish to use are available. The type you wish to use is 
determined by the magnetic medium the volume is on. 

2. Make the device your private device through the ALLOCATE 
command. 

3. Physically place the magnetic medium on the device drive. 
(This may be done for you by your system operator.) 

4. Mount the volume through the MOUNT command. 

If. the device you choose is DKl:, both the ALLOCATE and the MOUNT 
command refer to DKl:. In the ALLOCATE command, DKl: is the device 
itself, while in the MOUNT command, DKl: is the volume. In most 
cases, this distinction is not important, but you should understand 
that the expression ddnn: refers sometimes to a physical device and 
sometimes to a volume on the device. 
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5.1.2 Physical Devices, Pseudo Devices, LUNs, and Logical Names 

The purpose of devices of any kind is to handle I/O from tasks. 




The operating system often accesses physical devices as pseudo 
devices. Tasks access physical devices through logical unit numbers 
(LUNs) that establish a relationship between the I/O done by the task 
and the devices on the system. Finally, you can give any physical 
device a logical name. 



5.1.2.1 Pseudo Devices 

The names of pseudo devices are pseudonyms used by the system to 
access physical devices. System tasks are built to reference various 
pseudo devices. When the system is generated, the pseudo device names 
are associated with the physical devices that are actually present on 
the system. For instance, the system uses pseudo device LB: to refer 
to the disk location of the system libraries. At one installation, 
this might be DR2:, while at another, this might be DB7:, but whatever 
the actual physical device involved, the name LB: will always refer 
to the current disk location of the system libraries. 

Pseudo devices are implemented in several ways. Some pseudo device 
names are really only logical names. No system data structures are 
associated with logical names other than an entry in the system's 
Logical Unit Table (LUT) . Other pseudo device names are implemented 
through redirection from one physical device to another. Redirection 
requires more system data structures: a Device Control Block (DCB) 
and a Unit Control Block (UCB) . Finally, some pseudo device names are 
implemented through device drivers, which require not only full data 
structures but also the presence of the driver. 

Ore pce-.iuo dfvice, MI,:', found on RSX-11M~PIjUS only', also requires the 
presence of certain hardware. Thus, the term pseudo device does not 
refer to a single form of software, but rather to the concept that a 
usable device name is known to the system regardless of the 
installation's device configuration. 

Table 5-2 summarizes the pseudo devices on RSX-11M/M-PLUS systems. 
Pseudo device CO: is handled differently depending on whether the 
system includes Console Logging. Without Console Logging, CO: is 
redirected, usually to the main operator's terminal, often TTO:. 
Including Console Logging means a driver called CO: is used. This 
driver permits your system manager to send system console output to 
any device or to a file. See the RSX-11M/M-PLUS System Management 
Guide for more information on Console Logging. 

Pseudo device CL:, the Console Listing pseudo device, is commonly 
redirected to LPO:, the system line printer. 

LB:, the Library pseudo device, is the disk on which the system UFD is 
located . 

On RSX-11M-PLUS systems, the library UFD is also on pseudo device LB:. 
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Table 5-2 
Pseudo Devices on RSX-llM/M-PLUS 



Device 


How 




Name 


Implemented 


Hardware? 


CO: 


Redirection 




CO: 


Driver 




CL: 


Redirection 




LB: 


Redirection 




MK: 


Dr iver 


■ „,' ■ Yes 


NL: 


Driver 




RD: 


„' Driver :'',.., ""* - 




S P : 


. Redirection 




SY: 


Assignment 




TI: 


Dynamic 
Redirection 




VT: 


Driver 




WK: 


Assignment 




dd: 


Driver 


Yes 



Comments 



No Console Logging 
Console Logging present 



M-PLUS only 

M-PLUS only 
M-PLUS only 
User default device 

M-PLUS only 

Physical devices 



Pseudo device MK: is implemented through redirection for internal use 
on RSX-llM-PLUS systems and requires certain hardware to be present. 

Pseudo device NL:, the null device, is implemented through the NL: 
driver. Program testing often requires an available input or output 
device. The NL: pseudo device can be used for either of these 
purposes. 

For instance, if you are testing a program that normally generates 
large amounts of output, you can assign the appropriate LUN to NL: 
rather than wasting paper or disk space. The system discards output 
sent to NL:. On the other hand, if you are testing a program that 
ordinarily receives input from a device or file, NL: can generate 
usable input without any other source. When a task reads from NL: , 
the driver returns IE. EOF, the code for end of file. When a task 
writes to NL:, the driver returns IS.SUC, the code for success. 



Pseudo device RD: 
systems only. 



•-; the Rec nf igurati on Driver found ^n RSX-liM~PLUS 



Pseudo device SP: is used by the Queue Manager foi 
implemented through redirection . 



spool Lng and is . 



Pseudo device SY: is the logical name applied to the user's default 
or "home" device. This logical name is usually established by the 
LOGIN command and ACNT, the Account File Maintenance Program. This 
names the device to which all commands that do not specify a device 
name default. You can display your default device with the SHOW 
DEFAULT command. You can change your default device with the SET 
DEFAULT command or with the ASSIGN command. 
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Pseudo device TI : is always your terminal, regardless of its number 
or type. If you are logged in on two terminals, you have two TI:s. 
TI: is dynamically redirected on a per-command basis to your current 
terminal. TI: stands for terminal interface. 

On RSX~ 1 Jh~pl! ! o systems, tis*.- V'\'z drivor is used fur virtual terminals 
in batch processing. " / ; " ',.,,,<. '"" - - './' :: ' 

The WK: workfile pseudo device is used by a number of system tasks. 
WK: is named by assignment. 



NOTE 

Users can also assign logical names to 
devices (see the ASSIGN command, Section 
5.2), redirect devices (see the 
ASSIGN/REDIRECT command, Section 5.2.1), 
and write drivers (see the RSX-11M Guide 



to Writing an 


I/O Driver 


or 


the 


RSX-11M-PLUS Guide 


to Writing 


an 


I/O 


Driver) . 









5.1.2.2 LUNs 

Each task includes logical unit numbers, or LUNs, which establish a 
relationship between the I/O done by the task and physical device 
units. This relationship can be different for each task. 

Tasks may have from through 250 LUNs. The maximum number of LUNs is 
set when the task is linked, 

LUNs can be assigned or reassigned in three ways: 

• Any user can specify the ASG option at link time. 

• Privileged users can use ASSIGN/TASK (Section 5.2.2) to change 
the LUN assignments in an installed task. 

• The task can include the ALUN$ Executive directive (or CALL 
ASNLUN from FORTRAN) to change LUN assignments during 
execution. 



The Task Builder defaults build a task with 
assignments are as follows: 



Six LUNs. 



The default 



Device 


Li 


SYO: 


1 


SYO: 


2 


SYO : 




SYO: 


4 


TIO: 


5 


CLO: 


6 



This means a task linked with the default LUN assignments can 
simultaneously refer to up to as many as six files. Of these files, 
four can be on SY:. In this case, SY: is logical device name SY: as 
discussed in the previous section. Further, one file can be on pseudo 
device TI:, meaning that the terminal initiating the task can be used 
to communicate with the task. And finally, one file can be on pseudo 
device CL:, meaning that the task can send output to the console 
listing device, which is usually a line printer or hard-copy terminal. 
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Although the association of LUNs with physical or pseudo devices is 
established at link time, the actual assignment is not done until the 
task is installed, either explicitly, or through the 
install-run-remove form of RUN. 

Once the LUN is assigned, a task can map directly to a device without 
having to search device tables for the physical device. The LUN is 
simply a name used to represent the relationship between the logical 
device name and the physical device. 

LUN assignments are established on a task-by-task basis, in contrast 
to assignments through the privileged ASSIGN/REDIRECT command, which 
apply to all tasks using a device. 



5.1.2.3 Logical Device Names 

Logical device names provide a means by which tasks can maintain 
device independence. Logical device names have the same syntax as 
other device names, that is, ddnn : . The 2-character device name can 
be the same as a standard RSX-11M/M-PLUS device or pseudo device, such 
as DK: or LB:, or it can use two letters with an arbitrary meaning, 
such as AZ: . 

When you run a task that refers to a device by a logical name, first 
use the ASSIGN command to assign that logical name to the device. See 
Section 5.2. 

There are three types of logical device assignment: 

• Local assignments, which can be made by any user, apply only 
to tasks initiated from the terminal used to make the 

of assignments. Different users can assign the same local 
logical name to different devices. 

• Login assignments, which can be controlled only by privileged 
users through ACNT, the Account File Maintenance Program. 
Login assignments are reestablished each time the user logs 
in. Login assignments can also be established through 
ASSIGN/LOGIN, a privileged command. Login assignments 
override the next category, global assignments. Login 
assignments apply only to systems with multiuser protection. 
Login assignments remain in effect until the user logs off or 
until a privileged user deassigns them. 

• Global assignments, which can be made only by privileged 
users. Global assignments apply to all tasks running in the 
system. 

The Executive keeps a logical unit table that records all logical 
assignments and their types. Each time a task assigns a LUN, the 
Executive refers to this table before checking the list of physical 
devices and pseudo devices. Thus, a logical name found in the table 
has precedence over a physical device unit having the same identifier. 
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5.1.3 Public, Shared, Private and Unowned Devices and Mounted Volumes 

In general, no access to magnetic media on RSX-11M/M-PLUS systems is 
permitted without a MOUNT command. If a disk volume is in Files-11 
format, MOUNT grants access to the file system through the Files-11 
Ancillary Control Processor (F11ACP) . If the information on the 
medium is in some other format, or is unformatted, MOUNT/FOREIGN 
bypasses the ACP and the file system. (MOUNT/FOREIGN is required for 
foreign volumes on RSX-11M-PLUS. MOUNT/FOREIGN is not required but is 
recommended on RSX-11M. See Section 5.6). Use MOUNT/FOREIGN when 
initializing a volume or to use a custom ACP. 

Four categories of device ownership are supported on multiuser 
protection systems: Devices can be public, shareable, private, or 
unowned. Public devices are accessible to all. Within the limits of 
volume protection and file protection, shareable devices are 
accessible to all users who have mounted the device. Volumes on 
private devices are accessible only to the owner of the device. 
Volumes on unowned devices are accessible to no one on RSX-llM-PLUS. 
Volumes on unowned devices can be accessed on RSX-11M. 

Volume protection and file protection can greatly alter your rights of 
access to a particular volume or file. See Section 4.1.5 for more 
information . 

1. Public devices are accessible to all users; access is 
allowed automatically. Only a privileged user can set a 
device public. Devices are set public through the /PUBLIC 
qualifier to the SET DEVICE command (Section 5.10.2) or the 
/PUBLIC qualifier to the MOUNT command (Section 5.6). A 
public device cannot be mounted by any other user. The 
MOUNT/PUBLIC command sets the device public and deallocates 
it if it has been allocated. (An allocated device is a 
private device.) 

2. Shareable devices are accessible to all users who mount the 
volume. A device is made shareable through the /SHAREABLE 
qualifier to the MOUNT command. (Section 5.6) Nonprivileged 
users must know the volume label in order to mount the 
volume. Any number of users can mount the volume. It will 
remain mounted until the last user to mount the volume has 
dismounted it. You cannot mount a public or private device 
shareable. 

3. Private devices cannot be accessed by anyone but the owner, 
that is, the person who allocated the device. Devices can be 
made private with the ALLOCATE command (Section 5.4), or by 
the /NOSHAREABLE qualifier to MOUNT, which also allocates the 
device. The DISMOUNT command will deallocate the device. 

Users make devices private to prevent any other user from 
accessing the mounted volume. Any user can allocate a 
device, but your installation may have restrictions on the 
practice . 

4. Unowned devices are those that have not been allocated, 
mounted, or set public. 

RSX-11M systems permit limited access to unowned volumes, but 
such use is not advised. See the discussion under the 
/FOREIGN qualifier to MOUNT (Section 5. 6) . 

RSX-llM-PLUS permits 10 access to unowned volumes. 
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5.1.4 How to Prepare a Scratch Disk for Use 

A scratch disk is a blank disk or one on which the data is of no use. 
The prime example of a scratch disk is one that has never been used. 
Several system utilities and DCL commands are combined to prepare the 
scratch disk as a Files-11 volume. This section summarizes the 
process. 

1. Allocate an appropriate device and place the disk on the 
drive. Make sure the device is write-enabled. 

2. After physically placing the disk on its drive, spin it up 
and mount it using the /FOREIGN qualifier. This permits the 
system to access the disk but bypasses the file system. This 
step is optional on RSX-11M systems but required on 
RSX-11M-PLUS. 

3. You may need to write sector and timing information about the 
physical blocks on the disk. In most cases, disk formatting 
is done by the manufacturer, but some disks are shipped 
unformatted. If you have any question about formatting a 
disk, see your system manager. 

If formatting is necessary, you can use FMT, the Disk Volume 
Formatter Utility. Full information on this utility is given 
in Chapter 5 of the RSX-11M/M-PLUS Utilities Manual . To gain 
access to FMT from DCL, enter the command: 

>ftUN $FMT 
FMT> 

Now you can enter FMT commands. 

4. After you have a formatted disk, you must identify the bad 
blocks' on the disk. These are blocks that are physically 
unusable for some reason. This information is often written 
on disks when they are manufactured, but you can supplement 
this information with BAD, the Bad Block Locator Utility, 
described in Chapter 6 of the RSX-11M/M-PLUS Utilities 
Manual . In fact, FMT provides access to BAD, but you can 
also run BAD with the following command: 

>RUM *EAD 
BAD> 

5. Once you have a formatted disk with identified bad blocks, 
the disk driver and the disk controller have full use of the 
disk. In most cases, your scratch disk will already have 
formatting and bad-block data in place. Now you must provide 
the information that the file system needs to use the disk. 

This information is provided through the INITIALIZE command. 
Qualifiers to INITIALIZE permit you to set up your volume for 
the most efficient use by the system. The defaults for 
INITIALIZE produce a standard volume. 

INITIALIZE writes a Volume Home Block, which contains 
information for the system about the initialization, 
including the volume label that is used to control access to 
the volume by nonprivileged users. 
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INITIALIZE also creates five files used by the system to 
locate or create other files on the volume, Here are brief 
descriptions of these files: 



File 
000000. DIR 

INDEXF.SYS 



BADBLK.SYS 



BITMAP. SYS 



CORIMG.SYS 



Description 

This is the Master File Directory (MFD). 
It is a file that contains a list of User 
File Directories (UFDs) . The UFDs contain 
pointers to all named files on the volume. 

This is the. volume index file, which 
contains file-control information, such as 
file protection, creation date, the 
physical location of the file on the 
medium, and other information needed for 
the system to access the files on the 
volume. 

This is the bad-block file. All unusable 
blocks are included in this file. Any 
block that is included in a file is 
unavailable for any other use. 

This file contains information on all 
blocks used and free on the volume. The 
information is in the form of one bit for 
every block. If a block is used, the 
corresponding bit is set. 

This is the operating system checkpoint 
file. It is included on every volume. If 
the volume is not to provide for 
checkpointing, the checkpoint file is zero 
blocks long. 



6. Once the volume is initialized, it is no longer foreign. You 
must dismount it and mount it as a Files-11 volume. Use this 
sequence of commands: 

>DISMOUNT ddnn: 

>MOUNT ddnn: volumelabel 

Now the volume is a Files-11 volume. The file system has full access 
to the volume through a DIGITAL-supported ACP. If your system has a 
custom ACP for any device, you must mount the volume foreign and 
specify the ACP. 

You can alter some of the data placed in the Volume Home Block by 
INITIALIZE by using the INITIALIZE/UPDATE command. See Section 5.8.1. 

Certain system functions may also require that the volume be mounted 
foreign without specifying an ACP. You should check the appropriate 
documentation to be sure. This requirement may arise with the 
following DCL commands: 

• BACKUP, Section 5.9 

• INITIALIZE, Section 5.8 
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This requirement may also arise with the following utilities, 
described in the noted chapter of the RSX-11M/M-PLUS Utilities Manual ; 

• FLX, File Transfer Utility, described in Chapter 4 

• FMT, Disk Volume Formatter Utility, described in Chapter 5 

• BAD, Bad Block Locator Utility, described in Chapter 6 

• BRU, Backup and Restore Utility, described in Chapter 7, and 
accessed from DCL through BACKUP, Section 5.9 of this manual 

• DSC, Disk Save and Compress Utility, described in Chapter 8 

• VFY, File Structure Verification Utility, described in Chapter 
9 

• DMP, File Dump Utility, described in Chapter 11 



5.1.5 How to Prepare a Scratch ANSI Magnetic Tape for Use 

1. Allocate an appropriate device and place the tape on the 
drive. Make sure the device is wr ite-enabled. 

2. After you have physically placed the tape on the drive, mount 
the tape using the /FOREIGN qualifier. This permits the 
system to access the tape but bypasses the file system. This 
step is optional on RSX-11M systems but required on 
RSX-11M-PLUS. 

3. Now you must provide information that the file system needs 
to use the tape. This is done through the INITIALIZE 
command. Qualifiers to INITIALIZE permit you to set up your 
volume for the most efficient use by the system. The 
defaults for INITIALIZE produce a standard ANSI magnetic tape 
volume. 

INITIALIZE writes an ANSI volume label, which contains the 
File Set ID and also creates a dummy file. This dummy file 
is overwritten when the first user file is written to the 
tape. 

There are no UFDs in the ANSI magnetic tape structure. See 
the IAS/RSX-11 I/O Operations Reference Manual for more 
information on ANSI magnetic tapes. 

4. Once the volume is initialized, it is no longer foreign. You 
must now dismount the volume and remount it as an ANSI 
volume, using DISMOUNT and then MOUNT, this time without the 
/FOREIGN qualifier. 



5.1.6 Summary of Device and Volume Use Commands 

All Files-11 volumes and ANSI and unlabeled magnetic tapes must be 
mounted for any access. 

All other volumes are considered foreign volumes. Foreign volumes are 
normally mounted with the /FOREIGN qualifier to MOUNT. 

On RSX-11M, you are not required to mount foreign volumes, but if you 
do not, the system and other users have unlimited ■ .access,, to the 
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ASSIGN 



volume, as it is considered unowned.: MOUNT/FOREIGN is recommended for 
mdst use of foreign volumes on RSX-11M. • • •« 

On RS-X-.11M-PLUS, y~-,\ must mount foreign volumes. MOUNT/FOREIGN is 
required Foi al I. use of foreign volumes on RSX-11M~PLUS. 

Multiple users can mount a volume on a shareable device. The volume 
remains mounted until all users who have mounted it dismount it. 

Ownership of a device on a system with multiuser protection is of four 
kinds: 

• A volume on a private (allocated) device can be mounted by the 
owner only. 

• A volume mounted /SHAREABLE by the first user to mount it can 
be mounted by any other user who knows the volume label. The 
volume stays mounted until the last user to mount it dismounts 
it. 

• A volume on a public device is usually mounted after the 
device is set public. The system owns public devices. 
Mounting a public device means other users can access the 
device without mounting it. Only a privileged user can set a 
device public or nonpublic. Public devices cannot be 
allocated. 

• A volume on an unowned device can be mounted by anyone. 

Any user who mounts a volume has full access to that volume within the 
limits of privilege and volume and file protection. Privileged users 
have privileged access. Nonprivileged users have nonprivileged 
access. Nonprivileged users have privileged access to volumes mounted 
on their private (allocated) devices. 

A mounted device cannot be set public or nonpublic, and cannot be 
allocated or deallocated. 

LOGOUT issued by any user automatically dismounts any volumes mounted 
from that terminal and deallocates any devices allocated from that 
terminal. A mounted public device is not dismounted by LOGOUT, 
however. 



5.2 ASSIGN 

device, or other logical device. All references to the logical name 
are resolved by the system to the associated physical device, pseudo 
device, or logical device. 



Format 



ASSIGN [/qualifier [s] ] 

Device? ddnn: 

Logical device? logicalddnn: 

ASSIGN [/qualifier [s] ] ddnn: logicalddnn: 
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ASSIGN (Cont.) 



Command Qualifiers 

/LOCAL 

/LOGIN 

/GLOBAL 

/SYSTEM 

/TERMINAL: ttnn: 

Parameters 

ddnn: 

Specifies the name of the physical device, pseudo device, or 
logical device that is to receive the logical name. 

logicalddnn: 

Specifies the logical device name to be given to the physical 
device, pseudo device, or logical device. 

The logical device name consists of a 2-letter mnemonic followed 
by an octal number terminated with a colon (:). There is no 
restriction on logical device names. They may use standard 
device mnemonics, such as DKO: or SPO:, or random letters, such 
as AZ1: . 

Command Qualifiers 

/r.nr.Ar. 

Specifies that the assignment is to be a local assignment. This 
is the default qualifier. It need not be specified. Commands 
and tasks initiated from your terminal can access devices through 
the logical names assigned to them. No automatic deassignment 
occurs when you dismount the device. Any terminal can define its 
own set of local assignments. The terminal defining the local 
assignments is the only one for which the logical devices exist. 



/LOGIN 



Specifies that the assignment is to be a login assignment. This 
is a privileged qualifier. 

Login assignments occur only in systems that support multiuser 
protection. When a user issues a LOGIN command to log in to the 
system, the system automatically assigns the logical name SYO: 
to the user's system device, which is the device that contains 
the user's files. Login assignments are usually established 
through ACNT, the Account File Maintenance Program. ASSIGN/LOGIN 
does not alter the account file. 



/GLOBAL 
/SYSTEM 



Specifies' that the assignment is to be a global assignment. This 
is a privileged qualifier. /SYSTEM is a synonym included for 
VAX/VMS compatibility. 

Global assignments apply to all tasks running in thp system. 
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/TERMINAL :ttnn: 



Specifies that the requested local assignment be applied to 
another terminal. Only a privileged terminal may make 
assignments to other terminals. RSX-11M-PLUS only. 



Examples 



!: ASSIGN 
Device? DBU 
Losicsl device'' TPi: 



This example assigns the logical name TPI: to the physical 
device DB1:. The user may now issue commands referring to device 
TPI: in any command that accepts a device specification and DB1: 
will be substituted for it. 



>ASSIGN LBO! PR2J 

This example assigns the logical name RR2: to the pseudo device 
LBO:. 



. > A S S I G H / 7 E R H I N A L : T ' r 2 2 i ' D B 1 i i .. M !;."■■ 

This example assign;-, the logical name r.Nl: to the physical 
device DB1: for all commands and task'? initiated from TT22:. 
This command must be issued i rc«o a privileged t-r-rminai . 
RSX-llM-PLUS only. , . . 



>ASSIGN/6L0BAL DKlt XXI* 

This example assigns the logical name XXI: to the physical 
device DK1:. All users and tasks on the system can refer to XXI: 
when they initiate commands and tasks. This command must be 
issued from a privileged terminal. DK1: can also be used to 
reference DK1: . 



Notes 



Local assignments have precedence over both login and global 
assignments. Login assignments have precedence over global 
assignments. When a user deassigns a local logical name, the 
system defaults to any login assignment of the same name. 

You can display current assignments with SHOW ASSIGNMENTS, 
described in Section 5.10.1. 

ASSIGN is counteracted by DEASSIGN. See Section 5.3. 

You can assign SYO: with SET DEFAULT, described in Section 
4.5.1. 

ASSIGN/REDIRECT is a separate command, described in Section 
5.2.1. 

ASSIGN/TASK is a separate command, described in Section 5.2.2. 
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ASSIGN/REDIRECT 



ASSIGN/QUEUE is a separate command, described in the 
RSX-11M/M-PLUS Batch and Queue Operations Manual . 



5.2.1 ASSIGN/REDIRECT 

ASSIGN/REDIRECT redirects output from one physical device to another. 
You can also redirect a physical device to a pseudo device, or vice 
versa. Use this privileged command when a device is unavailable and 
you have another device that can take its place. The devices need not 
be of the same type. 

Format 

ASSIGN/REDIRECT 
From? oldddnn: 
To? newddnn: 

ASSIGN/REDIRECT oldddnn: newddnn: 
Parameters 
oldddnn: 

Specifies the device from which requests have been redirected. 

newddnn: 

Specifies the device to which subsequent requests for oldddnn: 
are to be redirected. 



Example 



>ASSIGN/REDIRECT DTO* DT3*. 
>SH0W DEVICES TYPE UTt 
DTOt do: LOADED 
DTI 5 LOADED 
DT2{ LOADED 
DT3*. LOADED 



>ASSIGN/RE:. DIRECT 


FROM? 


dto: 


TO? 


dto: 




>SH0W 


dev 


dt: 


dto: 




loaded 


DTI J 




loaded 


DT2J 




loaded 


DT3J 




LOADED 



This example shows the process of redirection. Following the 
first ASSIGN/REDIRECT, any output for DTO: is sent to DT3:, as 
indicated by the first SHOW DEVICES display. Later, when DTO: 
is again available, the user issues ASSIGN/REDIRECT again to 
redirect DTO: to DTO:. 



5-16 



HANDLING DEVICES AND VOLUMES 



ASSIGN/REDIRECT (Cont.) 



Notes 



Redirection does not affect any I/O requests already in the I/O 
queue. 

The following restrictions apply to this command: 

• You cannot redirect from or to a logical device name. 

• You cannot redirect from one pseudo device to another pseudo 
device. You can, however, redirect a pseudo device to a 
physical device or vice versa. 

You cannot redirect pseudo device TI:. 

You cannot redirect an attached or spooled device, 

You cannot redirect a device unit containing a mounted volume. 

You cannot redirect a logged-on terminal to a device other 
than another terminal. 






Error Messages 

A** — Circular redirect error 

Explanation: Command attempted to establish a circular list of 
redirections . 

User Action: Check available devices with SHOW DEVICES and set 
up legal redirection list. Reissue command. 

A** — Device not redirectable 

Explanation: Command attempted to redirect a device that cannot 
be redirected. 

User Action: Check command for proper device names and reenter. 
A** — New device not known to system 

Explanation: An ASSIGN/REDIRECT attempted to redirect to a new 
device that is not in the current system. 

User Action: Check the devices on the system with SHOW DEVICES. 
Retype the command after checking for proper device names. 

A** — old device attached 

Explanation: The oldddnn: specified in the command is attached 
or spooled. 

User Action: Find the cause of the error and proceed 
accordingly. 
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ASSIGN/TASK 



A** — old device mounted 

Explanation: The oldddnn: specified in the command contains a 
mounted volume. 

User Action: Wait for device to become available. 

A** — old device not known to system 

Explanation: An ASSIGN/REDIRECT attempted to redirect an unknown 
device. 

User Action: Check devices with SHOW DEVICES. Reenter command 
after checking for proper device names. 

A** — Pseudo device redirect error 

Explanation: Command attempted to redirect a pseudo device to 
another pseudo device. 

User Action: None. You cannot redirect a pseudo device to 
another pseudo device. 

A** — TI redirect error 

Explanation: Command attempted to reedirect pseudo device TI:. 

User Action: None. TI: cannot be redirected. 



5.2.2 ASSIGN/TASK 

ASSIGN/TASK reassigns an installed task's logical unit numbers (LUNs) 
from one physical device to another. 

The reassignment overrides the static LUN assignments in the task's 
disk image file. 

This is a privileged command. 

Format 

ASSIGN/TASK 
Task? taskname 
Device? ddnn: 
Logical Unit? lun 

ASSIGN/TASK: taskname ddnn: lun 
Parameters 
taskname 

Identifies the installed task whose LUN you wish to reassign. 
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ddnn: 

Specifies the new device to which you wish the LUN reassigned. 
This can be a physical device, pseudo device, or logical device 
name. 

lun 

Specifies which LUN you wish to reassign to the new device. 

Examples 

>AS9I6N/TASK:NIKiJA!\ 
Device? I'P-1 i 
Logical unit? 5 

This example overrides the assignment of LUN 5 established at 
link time and reassigns LUN 5 to DB1:. 

>hSSIGn/task:padwak ti i ; 4 

This example overrides the assignment of LUN 4 established at 
link time and reassigns LUN 4 to TT1:. 

> ASSIGN/TASK J GIV8GN Ail: 3 

This example overrides the assignment of LUN 3 established at 
link time and reassigns LUN 3 to logical device name AZ1:. 

Notes 

ASSIGN/TASK has no effect on a memory-resident task. Thus, this 
command has no effect on currently executing tasks or tasks fixed 
in memory. You can use ASSIGN/REDIRECT for dynamic device 
reassignments. 

Error Message 

A** -- Lun out of range 

Explanation: Command attempted to reassign a LUN that was higher 
than the maximum number of LUNs allocated during the task link. 

User Action: Issue SHOW TASK:taskname/LOGICAL_UNITS to determine 
how many LUNs were allocated. 



5.3 DEASSIGN 

DEASSIGN deletes logical-device assignments. DEASSIGN disassociates 
logical names from physical device names, pseudo device names, or 
logical device names assigned by ASSIGN. 
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Format 



DEASSIGN [/qualifier [s] ] 
Logical device? logicalddnn: 

DEASSIGN [/qualifier [s] ] logicalddnn: 

Command Qualifiers 

/LOCAL 
/ALL 

/ULUDHLl 

/SYSTEM 
/LOGIN 

/TERMINAL:ttnn: 

Parameter 

logicalddnn : 

Specifies the logical device name, assigned by ASSIGN, that is to 
be deassigned. This is a required parameter except with the /ALL 
qualifier. Logical device names have the same format as all 
other device names, a 2-letter mnemonic followed by an octal 
number terminated with a colon {:). 

Command Qualifiers 

Any other qualifier can be used with /ALL. The /TERMINAL 
qualifier can be used with /LOGIN or /LOCAL. 



/LOCAL 



Specifies that a local logical name is to be deleted. This is 
the default. 



/ALL 



Specifies that all assignments of the specified type are to be 
deleted. If this qualifier is used alone, all local assignments 
are deleted. This qualifier can be used with other qualifiers. 

/GLOBAL 
/SYSTEM 

Specifies that a global assignment is to be deleted. /TERMINAL 
may not be specified with /GLOBAL. /SYSTEM is a synonym included 
for VAX/VMS compatibility. 

This is a privileged qualifier. 

/LOGIN 

Specifies that a login assignment is to be deleted. 

This is a privileged qualifier. 
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/TERMINAL :ttnn: 



Specifies that the logical assignment to be deleted applies to 
another terminal. /TERMINAL may not be specified along with 
/GLOBAL . 

Only privileged terminals can delete assignments made from other 
terminals. This qualifier is for RSX-11M-PLUS only. 



Examples 

>DEASSIGN 

Logical device? TPO; 

This example deletes the assignment of logical device name TPO: 
to a device. 

>BEASSIGN/ALL 
This example deletes all local logical-name assignments. 

>DEAS/LCCAL/ALL 

This example is the equivalent of the previous example. /LOCAL 
is the default qualifier. 

>DE AS/LOCAL/ ALL /TERMINAL IT 12 II 

This example deletes all local assignments from terminal TT21:. 
This command must be issued from a privileged terminal. 

Notes 

DEASSIGN counteracts ASSIGN. 

You must type at least the first four characters of DEASSIGN. 

Login assignments are normally established through ACNT, the 
Account File Maintenance Program. 

You can display assignments with SHOW ASSIGNMENTS. See Section 
5.10.1. 

All local assignments disappear when you log out. 

DISMOUNT does not delete logical name assignments. 

DEASSIGN/QUEUE is a separate command. See the RSX-llM/M-PLUS 
Batch and Queue Operations Manual for more details. 

Error Message 

DEA -- Device not terminal 

Explanation: The /TERMINAL qualifier named a device that is not 
a terminal. 

User Action: Retype command after checking proper syntax. 
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5.4 ALLOCATE 

ALLOCATE declares a specified device to be a private device. 

Format 

ALLOCATE [qualifier [s] ] 
Device? dd[nn:] [logicalname] 

ALLOCATE [/qualifier [s] ] dd[nn:] [logicalname] 

Command Qualifier 

/TERMINAL :ttnn: 
/TYPE rdevicetype 

Parameters 

dd [nn: ] 

Specifies the device or device type to be allocated. 
The device name can be entered in one of two forms. 

• If you use the form ddnn:, the specified device is 
allocated, if available. 

• If you use the form dd without the number or the colon, the 
first available device of the specified type is allocated. 
This is called generic allocation. 

logicalname 

Assigns a logical name to the device as you allocate it. This 
parameter is optional. 

The logical name must be of the form xxnn:. Logical names take 
the same form as device names. The assignment is done 
automatically. 

Command Qualifiers 

/TERMINAL :ttnn: 

Allocates the device to the specified terminal. This is a 
privileged qualifier. 

/TYPE: device type 

Specifies the type of device you wish to allocate. Use this 
qualifier with the generic allocation feature. If you issue an 
ALLOCATE command with the device name specified in the form dd 
without unit number or colon, the first available device with the 
name dd is allocated. Since devices with names beginning with DB 
can be RP04s, RP05s, or RP06s, and since the disk packs for these 
devices are not compatible, you could do a generic allocation 
specifying /TYPE:RP04 to allocate the first available RP04. See 
the examples. 
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Examples 



>ALL0CATE DK 

ALL — DKOi Now allocs ted 

This example allocates the first available RK05 drive. The 
message gives the name of the device allocated, 

This is an example of a generic allocation. 

^ALLOCATE 
Device? DKli 



This example allocates the specified device. The allocation is 
confirmed by the return of the prompt. No message. 

>ALL OKI! 

ALL - - Device si located t a other use r 

This example shows an allocation that failed because the device 
named was not available. 



>ALL DB3; TPOt 

ALL — HB3! Now allocated 

This example allocates the specified device and assigns it the 
logical name TPO:. 

>ALLQCATE/TYF'E i RP04 DB 
ALL - - D B 3 t Now ,:< 1 1 o c 3 t e c! 

This example shows the use of the /TYPE qualifier. The user 
wished to allocate the first available RP04 but to ignore any 
other devices using the DB driver. This is also a generic 
allocation. 



Notes 



When you allocate a device, no other user can gain access to the 
device . 

DEALLOCATE counteracts ALLOCATE. See Section 5.5. 

If more than one user needs to access a volume on a device, the 
device should not be allocated. Each user should mount the 
volume. It remains mounted until all users who have mounted it 
have dismounted it. 

You cannot include ALLOCATE in RSX-11M-PLUS batch jobs. See the 
SS.X- 1 1 M/ M- PLUS Ba tch and Queue Operations M anual for information 
on private: devices in batch jobs. 
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Error Messages 

ALL — Device allocated to other user 

Explanation: Command attempted to allocate device already 
allocated by another user. 

User Action: Wait to allocate the device until the other user 
has deallocated it. (The terminal from which the device was 
allocated can be displayed by SHOW DEVICES.) 

ALL — Device attached 

Explanation: Command attempted to allocate device attached by 
running task. 

User Action: Wait to allocate device until task is finished. 

ALL -- Pseudo device error 

Explanation: Command attempted to allocate a pseudo device. 
Pseudo devices cannot be allocated. 

User Action: Retype command after checking proper device name. 
ALL — Public device 

Explanation: Command attempted to allocate a public device. 

User Action: Public devices cannot be allocated. 

ALL — User logged on terminal 

Explanation: Command attempted to allocate a terminal logged in 
by another user. 

User Action: Only terminals that are not logged in can be 
allocated . 



5.5 DEALLOCATE 

DEALLOCATE counteracts ALLOCATE. It frees a private device for access 
by other users. 



Format 



DEALLOCATE [/qualifier] 
Device? ddnn: 

DEALLOCATE [/qualifier] ddnn: 

Command Qualifiers 

/ALL 

/DEVICE 

/TERMINAL:ttnn: 
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parameter 

ddnn: 

Specifies the device to be deallocated. 

Command Qualifiers 

/ALL 

The /ALL qualifier frees all devices allocated from the terminal 
being used. If you use this qualifier, you cannot specify a 
device name. 

/DEVICE 

This qualifier is a no-op. 

/TERMINAL :ttnn: 

This qualifier enables a privileged user to deallocate devices 
allocated from another terminal. (RSX-11M-PLUS only.) 



Example 



>DEALL0CA7E 
Device? DBO; 



This example deallocates the device DBO: previously allocated by 
the user. 

Notes 

Nonprivileged users can deallocate only those devices that they 
have previously allocated. Privileged users can deallocate any 
private device. 

DEA is the short form of DEALLOCATE. 

Error Messages 

DEA — Device allocated to another user 

Explanation: Command attempted to deallocate a device allocated 
by another user. 

User Action: Nonprivileged users can only deallocate devices 
they have allocated from the same terminal. SHOW DEVICES 
displays the terminal from which the device was allocated. 

DEA — Device mounted 

Explanation: Command attempted to deallocate a mounted device. 

User Action: You cannot deallocate a mounted device. Dismount 
the device. 
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5 . 6 MOUNT 

MOUNT declares a volume to be logically known to the system, on line, 
and available for use. Some qualifiers can be used with any MOUNT 
command; some are limited to mounting disks (and other 
random-addressable devices) , and others are limited to mounting 
magnetic tapes. 

Format 

For Disks and Other Random-Addressable Devices 

MOUNT [/qualifier [s] ] ddnn: volumelabel 
For Magnetic Tapes 

MOUNT [/qualif ier[s] ] ddnn: [, ddnn: ... ] fileset-ID 

Command Qualifiers for Both Disks and Tapes 

/DEFAULT rarg 
SAVE 

[NO] UNLOAD 
/FILE_PROTECTION: (code) 
/FOREIGN 

/OVERRIDE: IDENTIFICATION 
/PARAMETERS: "user parameters" 
/PROCESSOR: arg 

acpname 

UNIQUE [ :acpname] 
/PROTECTION: (code) 
/PUBLIC 

/[NO] SHAREABLE 
/[NO] SHOW 

/SYSTEM (synonym for /PUBLIC) 
/[NO]WAIT 
/[NO]WRITE 

Command Qualifiers for Disks and Other Files-11 Devices 

/ACCESSED :n 
/EXTENSIONS 
/OWNER: [uic] 
/UNLOCK 
/WINDOW:arg 

n 

(USER:n,INDEX:n) 

FULL 
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Command Qualifiers for ANSI and Unlabeled Tapes 

/BLOCK_SIZE:n 
/CARRIAGE_CONTROL:arg 

FORTRAN 
LIST 
NONE 
/DENSITY:arg 

800 

1600 

6250 
/[NO]HDR3 
/[NO] LABEL 
/OVERRIDE: (arg[,s] ) 

ACCESSIBILITY 

EXPIRATION_DATE 

SET_IDENTIFICATION 
/RECORD_SIZE:n 
/TRANSLATE:arg 

EBCDIC 

NONE 

UTl 

UT2 

UT3 
/VOLUME_IDENTIFICATION: (volume-ID [ ,volume-ID [ ,s] ] ) 

Parameters 

ddnn: 

Specifies device on which the volume is to be mounted. You can 
mount only one disk or other random-addressable device, but you 
can mount several magnetic tapes. See the discussion of mounting 
tapes and tape sets in Section 5.6.1. 

NOTE 

Disks and magnetic tapes differ in the 
way labeling is handled. See the 
separate discussions of volumelabel and 
fileset-ID. See also Section 5.6.1 for 
more on magnetic tape Volume IDs and 
File Set IDs. 

volumelabel 

Specifies the volume label, that is, the name associated with the 
volume. volume labels are mandatory for nonprivileged users. 
You must supply a volume label for each volume you wish to mount. 
Disk and random-addressable volume labels can be as many as 12 
characters. 

Volume labels (or identifiers) can include any alphanumeric 
character without restriction, and can also include 
nonalphanumeric symbols, including the following: 

<space> ! "%_'()*+,-. /: <=>? 
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Labels including these characters must be enclosed in "quotes". 
If the label includes the quotation mark itself (") , the 
quotation mark must be followed by another quotation mark. The 
extra quotation marks do not count in figuring the length of the 
label. See the examples. 

Note that the at sign (@) , semicolon (;), and dollar sign ($) are 
not accepted in volume labels. 

f ileset-ID 

Magnetic tape Volume Identifiers or File Set Identifiers can be 
as many as six characters in length. By default, the Volume 
Identifier on the first tape named in a MOUNT command is taken as 
the File Set Identifier as well. See the discussion in Section 
5.6.1 for the distinction between magnetic tape File Set 
Identifiers and magnetic tape Volume Identifiers. 

Command Qualifiers 

/DEFAULT :arg 
SAVE 
[NO] UNLOAD 

This qualifier is for RSX-11M-PLUS systems only. It applies to 
DBi: , DM:, and DU: devices only. 

Specifies the default that will apply when the volume is 
dismounted. SAVE is a privileged argument and specifies that the 
medium is not unloaded and can be accessed for reads and writets 
by privileged tasks. UNLOAD specifies that the medium is to be 
unloaded \fter the dismount. This is the default for Files-11 
volumes. NOUNLOAE specifies that the medium is not to be 
unloaded. This is the default for foreign volumes. 

Only privileged users can specify /DEFAULT=UN).OAD for a multiunit 
device (for example, an RC25). 

ReFiviflb^ £ , these values c^u also fir. set 'when you : ssu- the 
DISMOUNT command. See Section 5.7. 

/FILE_PROTECTION: (code) 

Specifies the default file protection for any new files created 
on the volume while it is mounted. The file-protection code is 
enclosed in parentheses. See Section 4.1.5 for more information 
on file-protection codes and the relationship between file 
protection and volume protection. See also the /PROTECTION 
qualifier to MOUNT. 

The default file protection can be overridden by specifying 
another protection when the file is created. 

If this qualifier is not included, the value specified at the 
time the volume was initialized is applied. 

For ANSI magnetic tapes, this qualifier specifies the protection 

applied to the volume. See the RSX-11M/M = PLUS I/O O perat ions 

Manual for further information on ""the" " translation'"" From this 
coding to ANSI label coding. 
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/FOREIGN 

Specifies that the volume being mounted is not in Files-11 
format. Such volumes are called foreign volumes. Note that 
before a disk or tape has been initialized, it is a foreign 
volume. This qualifier functions slightly differently on RSX-11M 
and RSX-11M-PLUS. 

On RSX-11M, /FOREIGN is recommended but not required for mounting 

, foreign, volumes. ,, If you do not; mount the , :: volume,,, "access to the 

volume is unrestricted. If you mount a foreign volume /FOREIGN, 
no one else can access it. it you include /FOREIGN wiser, mounting 
the foreign volume /SHAREABLE, then other users must also mount 

the volume to access it. * ! ' ! ' ■ - ■ ' 

On RSX-11M-PLUS, this qualifier 4 s required for mounting foreign 
volumes . . ■ /• ~ '■ , ■ • . : < ' . - ■ J; ■. ■ f , > ■ ' - 

/OVERRIDE: IDENTIFICATION 

Allows privileged users to mount 
volume label (or the File 
Identification is the default argument for /OVERRIDE. 



a volume without using the 
Set ID for magnetic tape) . 



If you are mounting a magnetic tape, you may want to combine the 
IDENTIFICATION argument with other /OVERRIDE arguments that are 
limited to use with magnetic tape. See the description of 
/OVERRIDE in the magnetic tape section. 

/PARAMETERS: "user parameters" 

Enables you to enter commands to an ACP that is not DIGITAL 
standard. MOUNT/PARAMETERS passes a maximum of 40 characters 
enclosed in quotation marks to a foreign ACP. You must use the 
/FOREIGN and /PROCESSOR qualifiers with this qualifier. If the 
quoted command includes the quotation mark itself ("), the 
quotation mark must be followed by another quotation mark. The 
extra quotation marks do not count in figuring the length of the 
command . 

/PROCESSOR: arg 

acpname 

UNIQUE [:acpname] 

Allows privileged users to specify the name of the ACP to use to 
support file activity on the volume. In most cases, you can use 
the default ACP. The default ACP depends on the device type. 

If the device is a disk, MOUNT searches for an ACP with a name in 
the form ddnnFl. Failing that, MOUNT searches for an ACP with a 
name in the form ddAACP, and finally, for an ACP named FllACP. 
Thus, for an RK05 device, which uses the device name DK:, MOUNT 
looks first for an ACP named DKnnFl, where nn is the device 
number. If no ACP of that name exists, MOUNT looks for an ACP 
named DKAACP, and finally, for FllACP. 
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If the device is a DECtape, MOUNT first looks for an ACP with a 
name in the form ddnnFl. Thus, for a TC11 DECtape, which uses 
the device name DT:, MOUNT looks first for an ACP named DTnnFl, 
where nn is the device number. For a TU58 DECtape II, which uses 
the device name DD: , MOUNT looks for an ACP named DDnnFl. If no 
ACP of the appropriate name exists, MOUNT looks for an ACP named 
ddAACP, Failing that, MOUNT seeks an ACP named DTAACP, and 
finally, for the F11ACP. 

If the device is a magnetic tape, MOUNT first looks for an ACP 
with a name in the form ddnnFl. Thus, for a TS04 device, which 
uses the device name MS:, MOUNT looks first for an ACP named 
MSnnFl, where nn is the device number. If no ACP of that name 
exists, MOUNT looks for an ACP named MSAACP, and finally, for the 
MTAACP. 

You only have to specify an ACP in special cases. If an ACP has 
been written for a custom application in your installation, you 
will need to use that ACP for volumes used by that application. 
You will also have to include the /FOREIGN qualifier in this 
case. You may also need to use the /PARAMETERS qualifier to 
enter parameters used by that ACP. 

The UNIQUE argument specifies that a dedicated ACP is to be used 
for the volume being mounted. If you do not name an ACP with the 
UNIQUE argument, MOUNT creates a copy of the F11ACP if the device 
is a disk or DECtape, or of the MTAACP if the device is a 
magnetic tape. This unique ACP will be given a name of the form 
ddnnFl or ddnnACP. When the volume is dismounted and the file 
processor exits, the ACP is automatically removed. 

On RSX-11M-PLUS only, if the ACP (F11ACP or MTAACP) is installed 
in secondary pool, /PROCESSOR : UN QUE is the default. 

If you specify the UNIQUE argument naming a foreign ACP, that ACP 
is created and dedicated to your volume. If you name a foreign 
ACP, you need the /FOREIGN qualifier. You may also need the 
/PARAMETERS qualifier. 



SYSTEM MANAGERS 

You can control the resources dedicated 
to file processing by choosing 
appropriate names for installing ACPs. 
For example, if you wish DBO: to have a 
dedicated ACP and for DBl: and DB2: to 
use a shared ACP, install the F11ACP as 
DB00F1 and as DBAACP. 



If you mount a volume /FOREIGN but do not specify an ACP, no ACP 
can access the volume, but tasks such as INITIALIZE, DSC, BAD, or 
user tasks with non-file-structured device QIOs can access the 
foreign volume. 
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/PROTECTION: (code) 

Specifies the volume protection for Files-11 disks. This 
protection overrides the volume protection established when the 
volume was initialized. The /PROTECTION qualifier combines with 
the /OWNER qualifier to control access to the volume. See 
Section 4.1.5 for more information on volume protection. 

/PUBLIC 
/SYSTEM 

These two qualifiers are synonyms. The /SYSTEM qualifier is 
included for VAX/VMS compatibility. 

Privileged. Specifies that the mounted volume be available to 
all users who are allowed access under the volume-protection and 
file-protection codes established for the volume when mounted. 
See the discussion of file protection and volume protection in 
Section 4.1.5. 

If you state this qualifier explicitly when mounting a volume on 
an allocated (private) device, the device is automatically 
deallocated and set public, if necessary. 

If you do not state this qualifier explicitly, and the device is 
already set public, the mount will default to /PUBLIC. 

See the discussion of public, private, and shareable volumes in 
Section 5.1.3. 

/[NO] SHAREABLE 

Specifies whether the volume is to be mounted shareable. 

A volume mounted /SHAREABLE can be mounted multiple times by the 
same or different users. See the discussion of multiple mounts 
in Section 5.1.3. Each user's access is determined by the 
volume-protection and file-protection codes established for the 
volume when mounted. See the discussion of file protection and 
volume protection in Section 4.1.5. 

If you mount the volume /SHAREABLE and the device is allocated or 
set public, the device is automatically deallocated or set 
nonpublic. 

A volume mounted /NOSHAREABLE is dedicated for your private use. 
No other user can access the volume. For Files-11 volumes 
mounted /NOSHAREABLE, your privileges are SYSTEM privileges. See 
the discussion of file protection and volume protection in 
Section 4.1.5. 

If you specify /NOSHAREABLE explicitly when mounting a volume on 
a device, the device is allocated and set nonpublic, if 
necessary. 

If the device is already allocated, the mount defaults to 
/NOSHAREABLE. 

If the device is not allocated or set public, the default is 
/SHAREABLE. 
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If the device is set public, the default is /PUBLIC (synonym: 
/SYSTEM) . 

See the discussion of public, private, and shareable volumes in 
Section 5.1.3. 



/[NO] SHOW 



Specifies that information about the volume being mounted is to 
be displayed on your terminal. 

Here is the display format for disks and other random-addressable 
devices: 

Volume Information 

Class: Files-11 or Foreign 

Device: ddnn: 

Volume label: label 

Pack Serial: serial number supplied by manufacturer 

Owner: [g f m] 

Protection: code 

Default: code 

Processor: acpname 

The owner field indicates the owner of the volume. The UIC must 
be matched for protection checks for owner privileges. The owner 
UIC can be changed with the /OWNER qualifier. See Sections 5.1.3 
and 4.1.5 for more information. Protection indicates volume 
protection: Default indicates file protection. 

The information displayed by /SHOW is similar for magtapes. If 
multiple tape volumes are being mounted, the device and volume 
label information is repeated for each volume. The Protection 
and Default fields are omitted from the volume information for 
magtapes. 



/[NO]WAIT 



Specifies whether you require operator assistance in performing 
the mount. The main use of this qualifier is for batch jobs, 
indirect command files, or terminals distant from the machine 
room. The default is /WAIT for mounts in batch jobs .-nd indirect 
command files, and /NOWAIT for interactive mounts. 

If the mount is included in a batch job cr indirect command file, 
or if you specify /WAIT in an interactive mount, a message 
concerning the mount is sent to the operator's console and the 
mount is not completed until the operator physically places the 
disk on the drive and spins it up. If you specify /NOWAIT in a 
batch job or indirect command file, or if the mount is 
interactive, no message appears. The medium must have been 
placed on the device and readied for access (spun up/on-line) . 
See the examples. 

Batch processing is available on RSX-11M-PLUS systems only. For 
more information on mounts from batch jobs, see the discussion of 

MOUNT in the RSX-llM/M-PLUS Batch and Queue Operations Manual. 
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/[NO]WRITE 

Specifies whether the volume is to be write-protected . The 
default is /WRITE. If /WRITE is specified or implied, the volume 
can be written to as permitted by the volume-protection and 
file-protection codes established for the volume when mounted. 
See the discussion of volume protection and file protection in 
Section 4.1.5. If /NOWRITE is specified, no one may write to the 
volume . 

Command Qualifiers for Files-11 Devices 
/ACCESSED :n 

Specifies the approximate number of directories that will be 
accessed simultaneously during the mount. Legal values for n 
range from 1 through 127. F11ACP maintains a list of most 
recently used directories. The value specified for /ACCESSED 
sets the number of entries in this list. 

In general, directory operations can be significantly speeded up 
by increasing this value. If a directory appears in the list, no 
disk I/O is required to find the directory in the MFD. In 
addition, directory operations take place without the necessity 
of reading the directory file header. If this qualifier is not 
explicitly stated, the default is the value specified at the time 
the volume was initialized. Note that increasing the /ACCESSED 
value increases the amount of system pool used. 

/EXTENSIONrn 

Specifies the number of blocks by which a file will be extended 
if it exhausts its space allocation. The value of n can be from 
1 through 127. The default is the value specified when the 
volume was initialized. 

/OWNER: [g,m] 

Specifies the owner of the volume. The brackets are required 
syntax. This qualifier overrides the OWNER value established 
when the volume was initialized. The owner value is used with 
file and volume protection. See Section 4.1.5. 

/UNLOCK 

Specifies that the volume index file, [0,0] INDEXF.SYS, is 
unlocked. This means the file can be read and written to. 
Normally, this file is locked and can be read only. 

This qualifier has nothing to do with hardware or software 
write-locking. 
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/WINDOW: arg 
n 
(USER:n,INDEX:n) 

Specifies the default number of mapping pointers to be allocated 
for file windows when the file is accessed. Legal values for n 
range from 1 through 127 or the word FULL. A file window 
consists of a number of mapping pointers stored in memory when 
the file is opened. If you specify FULL, windows are created 
that map as much of the file as possible. 

If you wish, * 7 ou can specif* 7 different values for the user 
default and index file. If separate values are specified, the 
volume default will be the same as the user default specified and 
the index file window is created with the value specified. 

The default for /WINDOWS is the value specified in the Volume 
Home Block. This value is established when the volume is 
initialized. If you wish to change that value, see the 
INITIALIZE/UPDATE command (Section 5.8.1) for information on 
altering the Volume Home Block. 

Command Qualifiers for ANSI and Unlabeled Tapes 

/BLOCK_SIZE:n 

Specifies the block size in characters for unlabeled magnetic 
tapes at the time of the mount. Values for n can be from 18 
through 16000. This qualifier also works on ANSI Level 1 or 2 
magnetic tapes, that is, those without HDR2 records (labels) . 

/CARRIAGE_CONTROL:arg 

FORTRAN 

LIST 

NONE 

Specifies the record type for an unlabeled tape. The arguments 
correspond to the FORTRAN keywords for the OPEN statement. This 
qualifier also works on ANSI Level 1 or 2 magnetic tapes, that 
is, those without HDR2 records (labels) . This qualifier also 
works for ANSI Level 3 magnetic tapes that do not have a system 
code (HDR1 CP 61) beginning in DEC or OS. 

/DENSITY:arg 
800 
1600 
6250 

Specifies the density at which data is to be written to the tape. 
The default is the lowest density supported by the specified tape 
unit. If the specified tape unit does not support the density 
given, the command is rejected. 

/[NO]HDR3 
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/[NO] LABEL 

Specifies whether the tape volume is ANSI or unlabeled. An ANSI 
tape is specified by the /LABEL qualifier. This is the default. 
An unlabeled tape is specified by the /NOLABEL qualifier. 

/OVERRIDE: (arg[,s] ) 

ACCESSIBILITY 
EXPIRATION_DATE 
IDENTIFICATION 
SET_IDENTIFICATION 

This is a privileged qualifier. 

Specifies that you wish to override one or more characteristics 
of a tape volume that are normally checked when you mount a 
magnetic tape. The parentheses are optional if you wish to 
specify only one argument. If you wish to specify more than one 
argument, the arguments must be enclosed in parentheses and 
separated by commas. 

The ACCESSIBILITY argument specifies that you wish to override 
the protection on ANSI magnetic tapes. 

The EXPIRATION_DATE argument specifies that you wish to override 
the expiration date on ANSI magnetic tapes. 

The IDENTIFICATION argument specifies that you wish to mount the 
tape or tape set without specifying a File Set ID. By default, 
the File Set ID is the Volume ID of the first tape reel in the 
set. See Section 5.6.1. 

The SET_IDENTIFICATION argument specifies that you wish to mount 
a tape or tape set that does not follow ANSI standard. This 
argument is not otherwise needed. 

/RECORD_SIZE:n 

Specifies the record size in characters for unlabeled magnetic 
tapes. The value for n can be from 1 through the value for 
blocksize on the volume. 

/TRANSLATE :arg 

EBCDIC 

NONE 

UT1 

UT2 

UT3 

Specifies the character translation to take place for reading 
from and writing to the mounted unlabeled tape volume. NONE 
specifies no translation and is the default. EBCDIC specifies 
translation from ASCII to EBCDIC for writes and from EBCDIC to 
ASCII for reads. Note that the translation is not one-to-one 
because some characters are found only in EBCDIC or only in 
ASCII. UT1, UT2, or UT3 specify user-supplied translation tables 
that have been previously linked into the MTAACP. See the 
RSX-11M/M-PLUS I/O Operations Manual for further information on 
character translation. 
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/VOLUME_IDENTIFICATION: (volumelD [ ,volumeID [ ,s] ] ) 

Specifies Volume Identifiers. If you wish to check Volume IDs, 
you must specify this qualifier. If the File Set ID is not the 
same as the Volume ID of the first tape in the set, you must use 
this qualifier and include all Volume IDs in the set. See 
Section 5.6.1 for more information and for examples of this 
qualifier in use. 

Examples 

>MOUNT 

Device? DKlt 
Volume ID? HOTROD 

This example mounts the volume labeled HOTROD on device DK1:. If 
you are doing nothing more than mounting a volume to read from it 
or write to it, you will probably not need a more complicated 
MOUNT command than this. 

All default values for the mount come from the Volume Home Block. 
This block is written when the volume is created by INITIALIZE or 
by some other system task, such as a backup utility, that creates 
a file structure on the volume. Most of the qualifiers to MOUNT 
are used to override values in the Volume Home Block. 

>MOUNT/DENSITYU600 <HM0! -MM.U f f-iM2t > 'UI*MB*T' ,rQ0BAR»F00 

Specifies that a three-volume ANSI magnetic tape set be mounted 
on devices MMO: , MM1:, and MM2:. The volume labels are W*MB*T, 
FOOBAR, and FOO. The first label is included in quotes to allow 
specification of the asterisk (*) . Note that the comma between 
"W*MB*T" and FOOBAR is outside the quotation marks. 

>M0UNT/PR0CESS0R:HR'XACF/F0R£IGN/PARAMETER5: "MUMBLFRAZ" 

Device? DRO: 

Volume label? H A R P 

This example mounts the volume labeled HARPO on device DRO:. The 
volume's file structure is controlled by a non-DIGITAL ACP named 
MRXACP, so the ACP must be named and the volume mounted foreign. 
This ACP accepts special commands. These are entered using the 
/PARAMETERS qualifier with the command string in quotation marks. 

>M0UNT/NQL ABEL/BLOCK ! 2048/RECORJ) : 64/ CARR 5 FORTRAN/TRANSL : EBCDIC MM' 

The example mounts an unlabeled magnetic tape on device MM1: , 
specifying a block size of 2048 characters and a record size of 
64 characters. The volume includes FORTRAN carriage control, so 
that is specified. The volume's records are written in EBCDIC 
characters, so the user included the /TRANSLATE qualifier. The 
characters will be translated to ASCII for handling by the 
operating system and translated back to EBCDIC for writing to the 
tape volume. 
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The user wishes an operator to place the medium containing the 
proper volume in place on DB1: . The command may appear in a 
batch job, indirect command file, or interactive mount, perhaps 
from a user on a remote terminal. The following message appears 
on CO:, the operator's console: 

CO! Please mount volume WHIZZER on DBi- 

Type 

UNS <DCL START) when read* 

or 

RES <DCL CONTINUE) to reject reauest. 

The operator performs the requested operation and the mount takes 
place, if the device was available and the operator typed START 
(MCR UNS) . If the device was not available and the operator 

typed CONTINUE (MCR RES), the mount fails. The batch processor 
at temp " " to continue tnc job. The same is true if the command 
appeared in an indirect command file. 

Batch processing is available on RSX-.I1M-PLUS only. 



Notes 



You should not confuse mounting with physically placing the disk 
or other magnetic medium on a drive. Naturally, you must place 
the medium on a drive and spin it up (for a disk) or load it (for 
a tape) before you can do anything else with it, but mounting is 
enabling the system software to access the medium, either to read 
or write data, or to establish a file structure for the volume. 

If you attempt to mount a volume on a device where the disk is 
not properly spun up, MOUNT will wait 30 seconds and try the 
mount again. If the disk is not spun up after 30 seconds, the 
mount fails. This feature has nothing to do with the /WAIT 
qualifier. 

There are four states of device ownership: 

Private The device has been made private through the 
ALLOCATE command or the /NOSHAREABLE qualifier to 
MOUNT. Only you can access the volume. 

Shareable The device has been mounted /SHAREABLE. Any user 
can mount the volume. 

Public The device has been made public through the SET 
DEVICE/PUBLIC command or the /PUBLIC (or /SYSTEM) 
qualifier to MOUNT. Only a privileged user can 
set a device public. 

Unowned No one has mounted a volume on the device, nor is 
it allocated or set public. 

See the discussion of public, private, unowned, and shareable 
devices and mounted volumes in Section 5.1.3. 

You cannot put comments in a MOUNT command line. 
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DISMOUNT counteracts MOUNT. See Section 5.7 for a description of 
DISMOUNT with examples. 

Some file attributes and positioning information for magnetic 
tape volumes or tape sets can be supplied after mounting using 
the MAG utility. For more information, see the RSX-11M/M-PLUS 
I/O Drivers Reference Manual . 

See the introduction to this chapter for more information on how 
the operating system deals with devices and volumes. See also 
the description of the INITIALIZE command in Section 5.8. 



5.6.1 Mounting Magnetic Tapes and Tape Sets 

Mounting of magnetic tape volumes is handled by a special ACP, the 

MTAACP. This ACP handles not only magnetic tapes that meet the ANSI 

standard but also the most commonly encountered unlabeled tape 
formats. 

The MOUNT command can only mount a single random-addressable volume, 
but magnetic tapes can be mounted by the set. In fact, when you mount 
a single magnetic tape, you are mounting a set consisting of only one 
tape. A magnetic tape set consists of logically related records 
written on one or more individual reels of tape. Only the first tape 
in the set need be loaded on a device at the time the MOUNT command is 
issued. However, all tapes in the set can be loaded on different 
devices at the time the MOUNT command is issued. 

Therefore, the terminology used for mounting magnetic tapes is 
somewhat different from that used in mounting disks. The tape set is 
identified by a File Set Identifier (File Set ID). Each individual 
tape in the file set is identified by a Volume Identifier (Volume ID). 
By default, the File Set ID is the same as the Volume ID of the first 
individual reel of tape in the set. 

If you wish to use a File Set ID other than the Volume ID of the first 
reel in the set, you can do so on the first mount of a newly 
initialized tape as shown in the examples. 

Each installation using magnetic tapes extensively will have policies 
on File Set IDs and Volume IDs. See your system manager or supervisor 
for information on how they are used in your installation. 

The following examples establish the relationship between File Set IDs 
and Volume IDs. 

The following command 
>HOUNT MMO: F00 

mounts a tape set (consisting of a single physical reel) whose File 
Set ID is F00 and whose Volume ID is F00. The reel F00 must be loaded 
on device MMO: at the time of the mount. 
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The following command 

>H0UNT MMO: IiRAG/vOL.UME_iriENTIFICATION: (FOO, BAR, MORE) 

mounts a tape set whose File Set ID is DRAG and that consists of three 
physical reels with Volume IDs of FOO, BAR, and MORE. The reel with 
the Volume ID FOO must be loaded on device MMO:, but the other two 
reels are not loaded at the time of the mount. The File Set ID of the 
tape set was established with the first mount of the newly initialized 
tape set, using this same command. If this were the first mount, the 
File Set ID DRAG would be established by the MOUNT command, but the 
actual change of the File Set ID (from the default of FOO) does not 
take place until the first record is written to the tape. 

The command 

>hount/qverride:set_identificatic)n mmo: f fog* bar, more > 

mounts a tape set whose File Set ID is immaterial and that consists of 
three physical reels with Volume IDs of FOO, BAR, and MORE. The reel 
FOO must be loaded on device MMO:, but the other two reels are not 
loaded at the time of the mount. 

The following command 

>MOUNT MMO: FOO /VOLUME-I D I < A312 , A387 i B231 ) 

mounts a tape set whose File Set ID is FOO and that consists of three 
physical reels with Volume IDs A312, A387, and B231. The reel A312 
must be loaded on device MMO:, but the other two reels are not loaded 
at the time of the mount. 

The following command 

>M0UNT <hM0:»MMl!,MM2:> ( FOO , BAR , MORE ) 

mounts a tape set whose File Set ID is FOO and that consists of three 
physical reels with Volume IDs FOO, BAR, and MORE. At the time of the 
mount, the reel FOO must be loaded on device MMO:, the reel BAR must 
be loaded on device MM1: , and the reel MORE must be loaded on device 
MM 2: . 



NOTE 

There is no theoretical limit to the 
number of physical tape reels in a set, 
but your DCL MOUNT command must 
translate to an MCR MOU command of 80 
characters or fewer. There are, 
therefore, mounts that are permitted by 
the system but that cannot be translated 
successfully from DCL to MCR within that 
limit. In those cases, you cannot use 
the DCL MOUNT command but must use the 
MCR MOU command. Remember, you can use 
the MCR command to enter MCR commands 
from a DCL terminal. 
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Error Messages 

MOU — ACP not in system 

Explanation: The task specified as the ACP, or the default ACP, 
is not installed in the system. 

Dser Action: See your system manager. 

MOU — Device not in system -ddnn: 

Explanation: The command specified a device not present in the 
system. 

User Action: Retype command after checking device list (SHOW 
DEVICES) or see your system manager. 

MOU — Device specified twice 

Explanation: The command specified the same device twice. 

User Action: Retype command after checking proper syntax. 

MOU — Driver not loaded 

Explanation: The command named a device whose driver is not 
loaded. 

User Action: See your system manager. 

MOU — Failed to attach device -ddnn: 

Explanation: The command named a device that was attached by 
another task and could not be mounted. 

User Action: Check device list (SHOW DEVICES) and find out if 
the device is in use. See your system manager. 

MOU — Home block I/O error 

Explanation: An I/O error was detected in trying to read the 
Volume Home Block. This message often indicates that the device 
is not ready, or that the disk has not been initialized. 

User Action: Wait until the disk is spinning at full speed and 
try again. 

MOU — Illegal keyword combination 

Explanation: The command specified conflicting qualifiers. 

User Action: Retype command after checking proper syntax. 

MOU — Index file I/O error 

Explanation: MOUNT could not read either the index file header 
or the storage allocation file. 

User Action: See your system manager. 
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MOU -- No such device available 

Explanation: The command named a device not present in the 
system. 

Oser Action: Retype command after checking device list (SHOW 
DEVICES) or see your system manager. 

MOU — Not file-structured device 

Explanation: The command named a device that is not supported as 
a Files-11 device, including ANSI magnetic tape. 

User Action: Retype command after checking for proper device 
name. 

MOU — Parameter conflicts with mounted volume 

Explanation: An attempt was made to mount a previously mounted 
volume using qualifiers that conflict with those specified when 
the volume was originally mounted. 

User Action: Check with SHOW DEVICE and confirm qualifiers with 
other user. See your system manager. 

MOU — Storage bit map file I/O error 

Explanation: An I/O error was encountered while reading the 
storage allocation file. 

User Action: Check to be sure you have the correct magnetic 
medium, or the volume has not been initialized. See your system 

manager . 

MOU — Task not ACP 

Explanation: The task named with the /ACP qualifier does not 
have the characteristics of an ACP. 

User Action: Check to be sure you have named the right task. 
MOU — Undefined density selection 

Explanation: The command specified an illegal density value. 

User Action: Retype command after checking proper syntax. 

MOU — Unit allocated to or in use by another user 

Explanation: The command specified a device that is already in 
use. 

User Action: Check on the status of the device with SHOW DEVICES 
and take the appropriate action. 
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MOU — Unit does not support density switch 

Explanation: The command included a /DENSITY qualifier but named 
a device that does not accept it. 

Dser action: Retype command after checking proper syntax. 

MOU — Unit does not support 800 BPI 

Explanation: The command specified a device that does not 
support the 800 BPI density. 

User Action: Retype command after checking proper syntax. 

MOU — Unit does not support 1600 BPI 

Explanation: The command specified a device that does not 
support the 1600 BPI density. 

User Action: Retype command after checking proper syntax. 

MOU — Unsupported file header format 

Explanation: The Volume Home Block does not conform to Files-11 
format. Volume may be corrupted. 

User Action: Volume could be mounted with the /FOREIGN 
qualifier, or see your system manager. 

MOU — Volume aiready mounted -ddnn: 

Explanation: An attempt was made to mount a volume on a device 
that already had a mounted volume. In multiuser protection 
systems, only random-access devices can be mounted by multiple 
users. 

User Action: See your system manager. 

MOU — Wrong volume label 

Explanation: The volume label on the label and the volume label 
in the command do not match. 

User Action: Retype command after checking for proper volume 
label. Privileged users can use the /OVERRIDE: IDENTIFICATION 
qualifier . 



5.7 DISMOUNT 

DISMOUNT marks the volume mounted on the specified device to be 
logically off line and disconnected from the file system. Marking a 
volume for dismount prevents programs from opening new files on the 
volume. After all open files on the volume have been closed, the ACP 
dismounts the volume. 
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Format 



DISMOUNT [/qualifier [s] ] 
Device? ddnn: [volumelabel] 

DISMOUNT [/qualifier [s] ] ddnn: [volumelabel] 

Command Qualifiers 

/ALL 

/PUBLIC 

/SAVE 

/SYSTEM (synonym for /PUBLIC) 

/TERMINAL :ttnn: 

/[NO] UNLOAD 

Parameters 

ddnn: 

Specifies the device on which the volume is mounted, 
volumelabel 

Specifies the volume label or File Set ID for magnetic tape. 
This parameter is optional, but if it is specified, the label or 
File Set ID is checked against the mounted volume. The volume 
label or File Set ID can be a quoted string, following the same 
rules as explained in the discussion of MOUNT, Section 5.6.1. 
There is no prompt for this parameter. 

Command Qualifiers 

/ALL 

Specifies that all volumes mounted from the terminal at which the 
commmand is issued be dismounted. A message informs you of each 
dismount as it takes place. No device name or volume label is 
accepted with this qualifier. See the example. 

/PUBLIC 
/SYSTEM 



a 



Causes all users to be dismounted from a volume. This is 
privileged qualifier. A DISMOUNT/PUBLIC frees the device, no 
matter who has mounted the volume on it. This is the only way to 
dismount a public volume. /SYSTEM is a synonym for /PUBLIC, 
included for compatibility with VAX/VMS. 



/SAVE 



This qualifier is for RSX-llM-iM.US systems only. It applies to 
DB:, DM:, ant? DU: devices only. 

Specifies that the disk is K<> remain spinning in the drive and 
can be accessed foi read or write by privileged tasks. This is a 

privileged qualifier. . '..""/' "•":,...'..."'""' 
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The meet common use of /SAVE is when saving or backing up the 

system disk. f.f you simply wish to leave the disV. spinning, use 

trie /NOUNI.OAD qualifier. Remember, these values can also be set 
with th(." /DEFAULT qualifier to MOUNT. See Section 5.6. 

/TERMINAL: htnn: 

This qualifier is for RSX-11M-PLUS only. ^ . ■ 

Allows a privileged user to dismount, a volume mounted from 

.. another .terminal, . ' : ■ ■ .. " 

/[NO] UNLOAD ■ 

The /UNLOAD and /NOUNI.OAD qualifiers are for RSX-11M-PLUS systems 
only. They apply to DB: , DM: , and DU: disks and magnetic tapes- 
only. 

The /UNLOAD qualifier specifies that the disk is to spin down 
after the dismount. This is the default for Files-11 volumes. 
For magnetic tapes, this qualifier allows the tape to be 
completely rewound. 

You can spin down the removable unit of a multiunit device (for 
example, the RC25) only if you are a privileged user. If you are 
a nonprivileged user and you try to dismount the unit or specify 
/UNLOAD iin the command line, you will get a warning message; that 
the vblumb cannot be spun down. 

The /NOUNLOAD qualifier specifies that the disk is to remain 
spinning after the dismount. This is the default for foreign 
mounted volumes. The /NOUNLOAD qualifier is useful when the 
volume is to be immediately remounted. For magnetic tapes, this 
qualifier rewinds the tape to the first file position. 

See Section 5.1.7 for more information on /[NO]UNLOAD and the 
related /SAVE qualifier. Remember, these values can also be set 
with • - , IFAULT lualif r to MOUNT. See Section 5.6. 



Examples 



> DISMOUNT 
Device? DKOt 



DIS -- TT11J D.i-s mounted from DKOt *** i:: 'inel Dismount Initiated *« 

This example dismounts a volume on device DKO:. No other user 
had the volume mounted when the DISMOUNT command was issued. 



>DISM0UNT DKi: HOTROD 

DIS -- TT56! Dismounted from DKO! 

This example dismounts a volume on device DKI:. The user 
specified the label HOTROD to be sure the correct volume was 
mounted on the device. The volume was mounted shareable and some 
other user also has it mounted, so the informational message does 
not include the notification of final dismount. 
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>L0G0UT 

HMO ---- TTli J Dismounted frosi DXCI **'* Fins I dismount *## 

Have 3 Sood mo r n i n ;i 

22--N0V-82 TT1U Loosed off 

This example dismounts a volume as part of the LOGOUT procedure. 
The user had the volume mounted on the device and had not 
dismounted it before logging off. LOGOUT dismounted the volume. 
If the device was allocated, LOGOUT also deallocated it. This is 
the equivalent of DISMOUNT/ALL. 

The informational message is headed by DMO rather than DIS 
because, at this point, DCL is no longer involved in the 
dismount. 

>DISMOUNT/AL.L 

DIS -~ TTli: Dismounted from DKOt 

DIS --- Till! Dismounted from DKlt *** Final dismount *** 

DIS -- TTli: Dismounted from MM 21 *** Final dismount #** 

This example dismounts all volumes mounted from the terminal at 
which the DISMOUNT was issued. See next example. 

>DISMOUNT/ALL 

DIS ■-- TTli J Dismounted from DKOI 

DIS -- TTli: Dismounted froii, DXlt #** Finsl dismount *« 

DIS -- TTli; Dismounted from MM2I *** Final dismount **# 

>M0UNT DXlt CRUCIAL. 

This example dismounts all volumes mounted from the terminal at 
which the DISMOUNT was issued. The message reminds the user that 
a volume was mounted on DX1:. As this volume was necessary to a 
running task, the user immediately issued a new MOUNT command 
using the volume label CRUCIAL. So long as the task did not 
attempt to open a file and did not close its last file between 
the time of the message and the time of the new MOUNT, the 
DISMOUNT has no effect on the task. All files that the task had 
open remain open. 

^■DISMOUNT/PUBLIC DB3*. 

DIS -- TT21J Dismounted from DB3J 

DIS - - T "(' 2 7 : D i s m o u n t e d f r o m D B 3 t 

DIS -- TT31J Dismounted fv-oni DB3; 

DIS --- TT55* Dismounted from DB3t *** Final dismount *** 

In this example, a privileged user dismounted all users who had 
mounted the volume on DB3:. 

Notes 

DISMOUNT counteracts MOUNT. 

LOGOUT issues a DISMOUNT/ALL automatically. DISMOUNT/ALL 
dismounts all volumes mounted from the terminal, whether mounted 
explicitly through a MOUNT command or implicitly through a task 
that spawns a MOUNT command. 
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You cannot include comments in a DISMOUNT command line. 

The messages from the ACP to your terminal indicate only that the 
volume is marked for dismount. The actual completion of the 
dismount is noted on the operator's console. 

CAUTION 

When the dismount operation is complete, the ACP prints 
the following message on the operator's console (CO:): 

*** ddnn Dismount complete 

This message does not appear until all files open on the 
volume are closed. Do not remove the medium from the 
drive until this message appears on CO:. If you remove 
the medium before the message appears, the present volume 
may be corrupted and the next volume mounted on that 
device will be corrupted. 

Error Messages 

DIS — Warning — All units of multiunit drive will spin down <ddnn:> 

Explanation: When a unit of a multiunit device is spun down (by 
a privileged user) , all other units of the device are also spun 
down. This warning message appears on RSX-11M-PLUS systems only. 

DIS — Warning — Volume will not spin down <ddnn:> 

Explanation: An attempt was made by a nonpr ivileged user to spin 
down the removable unit of a multiunit device, either implicitly 
with the DISMOUNT command or explicitly by specifying /UNLOAD in 
the command line. Only privileged users can spin down multiunit 
devices. (For nonprivileged users, the volume is logically 
dismounted but not spun down.) This warning message appears on 
RSX-11M-PLUS systems only. 

DIS — Checkpoint file still active 

Explanation: The command attempted to dismount a volume that 
contained an active checkpoint file. The volume cannot be 
dismounted until the checkpoint file has been closed. 

User Action: Wait, or, if privileged, issue a SET 

DEVICE:ddnn:/NOCHECKPOINT and reissue the DISMOUNT after 

receiving the system message indicating that the checkpoint file 
is no longer active. 

DIS — Volume not mounted 

Explanation: The command specified a device that was not 
mounted. 

User Action: Retype command after checking SHOW DEVICES for 
mounted devices. 
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DIS — Volume not mounted by TI: 

Explanation: The command attempted to dismount a volume mounted 
from another terminal. 

User Action: Dismount the volume from the proper terminal, or 
have a privileged user dismount the volume. 

DIS — Wrong volume label 

Explanation: The command included an incorrect volume label. 

User Action: Reissue the command without specifying a volume 
label or check the volume label to be sure you are dismounting 
the right volume. 



5.8 INITIALIZE 

INITIALIZE produces a volume in Files-11 format. 

For disks and DECtapes, INITIALIZE destroys all existing files, writes 
a dummy bootstrap and a Volume Home Block, and builds the directory 
structure. 

For magnetic tapes, INITIALIZE writes an ANSI standard volume label 
and a dummy file that destroys all existing files. 

Many of the values specified in the INITIALIZE command can be changed 
with the INITIALIZE/UPDATE command without disturbing existing data on 
the volume. See Section 5.8.1. 



Format 



INITIALIZE [/qualifier [s] ] 
Device? ddnn: 
Label? volume label 

INITIALIZE [/qualifier [s] ] ddnn: volumelabel (volume-ID) 

Command Qualifiers 

/ACCESSED :n 
/DENSITY:arg 
800 
1600 
6250 
/EXTENSIONS 
/HEADERS :n 
/INDEX:arg 

BEGINNING 

MIDDLE 

END 

n 
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/MAXIMUM_FILES:n 
/OWNER: [g,m] 
/FILE_PROTECTION: (code) 
/PROTECTION: (code) 
/[NO] SHOW 
/BAD_BLOCKS:arg 

AUTOMATIC 

MANUAL 

OVERRIDE 
/WINDOWS :n 

Parameters 

ddnn : 

Specifies the name of the device on which the magnetic medium to 
contain the volume has been placed. 

volume label 

Specifies the label the volume is to be initialized with. The 
label names the volume and must be specified by nonprivileged 
users when they mount the volume. The volume label is in effect 
a password controlling access to the volume. For magnetic tapes, 
the situation is more complex. See Section 5.6.1. 

For disks and DECtapes, volumelabel can be as many as 12 
characters. 

For magnetic tapes, Volume ID can be as many as six characters. 

See Section 5.6, the MOUNT command description, for details on 
the characters that can be included in volume labels and Volume 
IDs. 

Command Qualifiers 

Selecting command qualifiers for INITIALIZE requires a good 
knowledge of the Files-11 file structure. You should see the 
IAS/RSX-11 I/O Operations Reference Manual for further 
information. 

Defaults to INITIALIZE enable you to initialize a volume in a 
standard fashion, but the qualifiers allow much more flexibility 
in using the system. 

/ACCESSED :n 

This qualifier specifies the number of directories that will be 
accessed simultaneously. F11ACP maintains a list of most 
recently used directories. If a directory is in this list, no 
disk I/O is required to find the directory in the Master File 
Directory, nor do directory operations require that the directory 
file header be read. In general, directory operations can be 
speeded up significantly by increasing the /ACCESSED count but at 
the potential cost of pool. 

The default n is 3. Legal values for n range from 1 through 127. 
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/DENSITY:arg 
800 
1600 
6250 
HIGH 
LOW 



Specifies the density in bits per inch (bpi) for the medium 
loaded on the device. The argument can be 800, 1600, 6250, HIGH, 
or LOW, depending on the device type. Only volumes on media for 
certain devices can be initialized at different densities. You 
must mount the volume at the same density with which it was 
initialized. 

This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1. 

Here are the acceptable density values for DIGITAL devices with 
switchable density: 

Mnemonic 

MF: (magnetic tape) 



MM: (magnetic tape) 

MM: (magnetic tape) 

MM: (magnetic tape) 

MM: (magnetic tape) 

MS: (magnetic tape) 

DY: (floppy) 



Device 


Densities 


TU78 


1600 






6250 


(default) 


TE16 


800 
1600 


(default) 


TU16 


800 
1600 


(default) 


TU45 


800 
1600 


(default) 


TU77 


800 
1600 


(default) 


TS11 


1600 




RX02 


LOW 


(or singl 



HIGH (or double) (default) 



/EXTENSIONS 



Specifies the number of blocks by which the file is to be 
extended when its allotted space is exhausted. Default n is 5. 

This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1~ 



/HEADERS:n 



Specifies the number of file headers to be allocated initially in 
the index file. The five system files INDEXF.SYS, BITMAP. SYS, 
CORIMG.SYS, BADBLK.SYS, and 000000. DIR are not included in the 
value for n. 
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The default value of n is proportional to the capacity of the 
medium; the minimum allocation is 16 headers. 

File Headers 
Allocated Initially (n) 

16 

16 

147 

834 

1654 

314 

629 

1230 

2460 

5283 

10478 

4049 

25593 

51699 

16 

16 

12308 

7314 

51699 

3020 

602 

7461 

16 

16 

16 

Varies 

/MAXIMUM_FILES:n 

Specifies the maximum number of files permitted on the volume. 

The value of n includes the five system files. The value of n 
must be less than or equal to the maximum value of n given in the 
table. The following table also includes the default values of n 
for each device. 



Mnemonic 


Device 


DD: 


DECtape II 


DF: 


RF11 


DK: 


RK05 


DK: 


RK06 


DK: 


RK07 


DL: 


RL01 


DL: 


RL02 


DP: 


RP02 


DP: 


RP03 


DP: 


RP04/05 


DP: 


RP06 


DR: 


RM02/03 


DR: 


RM05 


DR: 


RP07 


DS: 


RS03/04 


DT: 


DECtape 


DU: 


RA60 


DU: 


RA80 


DU: 


RA81 


DU: 


RC25/RCF25 


DU: 


RD51 


DU: 


RM80 


DU: 


RX50 


DX: 


RX01 


DY: 


RX02 


EM: 


ML11 



Mnemonic 


Device 


Default n 


Maximum n 


DD: 


DECtape II 


30 


247 


DF: 


RF11 


62 


499 


DK: 


RK05 


294 


2357 


DK: 


RK06 


1668 


13344 


DK: 


RK07 


3308 


25600 


DL: 


RL01 


629 


5034 


DL: 


RL02 


1259 


10074 


DP: 


RP02 


2460 


19680 


DP: 


RP03 


4920 


25600 


DP: 


RP04/05 


10567 


25600 


DP: 


RP06 


20956 


25600 


DR: 


RM02/03 


8099 


25600 


DR: 


RM02/03 


8099 


64798 


DR: 


RM05 


30781 


65500 


DR: 


RP07 


62007 


65500 
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DS: 


RS03 


62 


499 


DS: 


RS04 


125 


1003 


DT: 


DECtape 


34 


278 


DU: 


RA60 


24617 


65500 


DU: 


RA80 


14629 


65500 


DU: 


RA81 


54815 


65500 


DU: 


RC25/RCF2 5 


6040 


48326 


DU: 


RD51 


1204 


9633 


DU: 


RM80 


14923 


65500 


DU: 


RX50 


48 


388 


DX: 


RX01 


29 


238 


DY: 


RX02 


60 


481 


EM: 


ML11 


Varies 


Varies 



This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1. 

/INDEX:arg 

BEGINNING 

MIDDLE 

END 

n 

Specifies the location of the index file on the volume. This 
qualifier forces a specified location for the index file, the 
Master File Directory, and the storage allocation file. This is 
usually done to minimize access time. 

Four possibilities are available for the argument field: 

BEGINNING The beginning of the volume. This is the default 
for tapes and DECtapes. 



This is the default for 



MIDDLE The middle of the volume, 
most disks. 

END The end of the volume. 

n Logical block n. 

/FILE_PROTECTION: (code) 

Specifies the default protection for all files on the volume 
being initialized. See Section 4.1.5 for more information on 
file protection codes. 

Default protection code: 

(SYSTEM : RWED , OWNER : RWED , GROUP : RWED , WORLD : R) 

This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1. 

/OWNER: [g,m] 

The /OWNER qualifier specifies the owner of the volume. Group 
and member numbers range from 1 through 377. The default owner 
is [1,1]. The /OWNER value is used for checking volume and file 
protection. See Section 4.1.5 for more information on volume and 
file protection. 
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/PROTECTION: (code) 

The /PROTECTION qualifier specifies the default protection for 
new files created on the volume. See the discussion of volume 
protection in Section 4.1.5. The code for volume protection is 
similar to that for file protection, except that the "E" for 
EXTEND protection is replaced by a "C" for CREATE protection. 

/[NO] SHOW 



The /SHOW qualifier specifies that you wish to see all the values 



WlLll Wll X <~L1 

default. 



the vol 



ame 



13 DSinCj lul l.13x1Z €u • /NOGwvA 1» 



:he 



These values are identified in MCR terms, 
equivalents: 



Here are the DCL 



Display 



DCL Equivalent 



Label 


Label 


/Bad 


/BAD BLOCKS 


/Cha 


Not used by RSX-11M/M-PLUS 


/Ext. 


/EXTENSION 


/FPro. 


/FILE PROTECTION 


/Indx . 


/INDEX 


/Inf. 


/HEADERS 


/Lru. 


/ACCESSED 


/Mxf . 


/MAXIMUM FILES 


/Pro, 


/PROTECTION 


/Uic. 


/OWNER 


/Win 


/WINDOWS 


/BAD BLOCKS :arg 




AUTOMATIC 




MANUAL 




OVERRIDE 





/BAD_BLOCKS: AUTOMATIC specifies that bad-block information for 
the "volume is to be determined automatically from a file named 
BADBLK.SYS created by the BAD utility. This is the default. 

/BAD_BLOCKS : MANUAL specifies that bad-block information for the 
volume is to be entered manually. 

/BAD_BLOCKS: OVERRIDE specifies that bad-block information is to 
be ignored. 

See Chapter 6 of the RSX-11M/M-PLUS Utilities Manual for more 
information on BAD. 



/WINDOWS :n 



Specifies the number of mapping pointers to be allocated for file 
windows. A file window consists of a number of mapping pointers 
stored in memory when the file is opened. Default n is 7. 

This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1. 
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Examples 



MNIIALIZE 
Device? DKOJ 
Volume ID? HONOLULU 

This example initializes a volume with the volume label HONOLULU 
on device DKO:. See next example. 



^ALLOCATE DKO; 
>M0UNT/F0REIGN DKOJ 
^INITIALIZE DKOJ HONOLULU 
^DISMOUNT DKO: 
>MQUNT DKOJ HONOLULU 

This example illustrates the process necessary to turn a fresh 
disk into a volume in Files-11 format that you can use. (This 
example assumes bad block information from BAD has already been 
written on the medium.) See Section 5.1.4 for a more detailed 
treatment of this process. 

First the device is allocated, or made private, so that no other 
user can access the device during this process. Then 
MOUNT/FOREIGN provides access to the disk although it is not yet 
in Files-11 format. The volume is initialized and given the name 
HONOLULU. The volume is then dismounted. Finally, the volume is 
mounted conventionally using the volume label HONOLULU. The 
/FOREIGN qualifier is not required on RSX-llM. 

> IN IT/ INDEX ; END/PROTECTION ; < SYSTEM J RUED , OWNER J , GROUP I , ■■ 
->UORLDJ) DK1! MIRACLE 

This example initializes a volume named MIRACLE on a medium 
mounted on device DK1:. The index file is placed at the end of 
the volume. Files on the volume are accessible to the system and 
privileged users only. The user used the continuation character 
(-) to make room for the command on a narrow terminal. 



Notes 



Nonprivileged users must allocate the device on which the volume 
is to be initialized. 

On RSX-llM systems, the medium need not be mounted to be 
initialized, but mounting with the /FOREIGN qualifier is 
recoranended . 

On RSX-11M-PLUS, you must use MOUNT/FOREIGN before INITIALIZE. 

See Section 5.6 for a discussion of MOUNT/FOREIGN as it applies 
differently to RSX-llM and RSX-11M-PLUS. 
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Error Messages 

INI — Allocation for syst file exceeds volume limit 

Explanation: The system was unable to allocate a system file 
from the specified block because of intermediate bad blocks or 
end of volume. 

User Action: Enter command with different argument for the 
/INDEX: qualifier. 

INI — Bad block file corrupt - data ignored 

Explanation: Although the /BAD_BLOCKS qualifier was selected, or 
defaulted to, the bad block data on the disk was not in the 
correct format and was therefore ignored. 

User Action: Process the medium with the BAD utility and 
initialize again. 

INI — Block (s) exceed volume limit 

Explanation: The specified block or blocks exceeded the physical 
size of the volume. 

User Action: Retype command after checking for proper qualifier 
values. 

INI — Boot block write error 

Explanation: An error was detected in writing out the volume 
boot block. 

User Action: Reenter the command. If it still does not work, 
see your system manager. 

INI — Checkpoint file header I/O error 

Explanation: An error was detected in writing out the checkpoint 
file header. 

User Action: Reenter the command. If it still does not work, 
see your system manager. 

INI — Command I/O error 

Explanation: INITIALIZE encountered an I/O error while reading 
the command line. 

User Action: Retype command line. If this fails, see your 
system manager. 

INI — Data error 

Explanation: The command specified a bad block number or 
contiguous region that was too large. 

User Action: Retype command after checking proper syntax. 
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INI — Device allocated to other user - ddnn: 

Explanation: Command specified a private device not allocated to 
your terminal. 

User Action: Retype command after checking SHOW DEVICES for 
proper device name. 

INI — Device not in system 

Explanation: Command specified a device not in the current 
system. 

User Action: Retype command after checking SHOW DEVICES for 
proper device name. 

INI — Device not ready -ddnn: 

Explanation: The device was not up to speed (spun up) . 

Dser Action: Wait and try again. 

INI — Driver not loaded 

Explanation: Command specified a device for which the driver is 
not loaded. 

User Action: Retype command after checking SHOW DEVICES for 
proper device name. 

INI — Failed to attach device -ddnn: 

Explanation: INITIALIZE failed to attach the specified device. 

User Action: Wait and try again. Check SHOW DEVICES. See your 
system manager. 

INI -- Magtape label must be specified 

Explanation: Command attempted to initialize a magnetic tape 
volume without specifying the required volume label. 

User Action: Retype command after checking proper syntax. 
Magnetic tape volume labels are limited to six characters. 

INI — Magtape write error -ddnn: 

Explanation: While writing to the magnetic tape, the system 
encountered an I/O error. 

User Action: Retype command. 

INI -- No bad block data found 

Explanation: Although the /BAD_BLOCKS: AUTOMATIC qualifier was 
specified, or defaulted to, no bad-block data was found. 

User Action: Process the medium through BAD utility and try 
again. 
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INI — Not file structured 

Explanation: The system does not support the device named as a 
Files-11 device. 

User Action: Retype command after checking proper syntax. 

INI — Public device -ddnn: 

Explanation: Command attempted to initialize a volume on a 
public device. 

User Action: Nonprivileged users can only initialize volumes on 
private devices. 

INI — Undefined density selection 

Explanation: Command specified an illegal density argument for 
the device named. 

User Action: Retype command after checking for proper density 
argument . 

INI — Unit is not at high density 

Explanation: Command specified that floppy disk in RX02 (DYnn:) 
drive be initialized at low density, but floppy was formatted at 
high density. 

User Action: Reformat floppy, or change it. 

INI — Unit is not at low density 

Explanation: Command specified that floppy disk in RX02 (DYnn:) 
drive be initialized at high density, but the floppy was 
formatted at low density. 

User Action: Reformat floppy, or change it. 

INI — Volume mounted Files-11 

Explanation: Command attempted to initialize a volume mounted 
Files-11. 

User Action: Check to make sure you have the right volume. 

INI — Volume mounted foreign with ACP 

Explanation: Command attempted to initialize a volume mounted 
/FOREIGN but with the /ACP qualifier. 

User Action: Remount the volume without the /ACP qualifier. 

INI — Volume name too long — volumelabel 

Explanation: Command included a volume label that was too long. 

User Action: Retype command but limit volume label for disks or 
DECtapes to 12 characters; magnetic tapes to six characters. 
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5.8.1 INITIALIZE/UPDATE 

INITIALIZE creates a Volume Home Block that includes a number of 
values used by the ACP when you mount the volume. INITIALIZE/UPDATE 
uses the HOME utility to alter some of those values without affecting 
the other data on the volume. The INITIALIZE/UPDATE command is only 
for disk and DECtape volumes in Files-11 format. 

Format 

/INITIALIZE/UPDATE [/qualifier [s] ] ddnn: volumelabel 

Command Qualifiers 

/ACCESSED :n 
/DENSITY:arg 

800 

1600 

6250 
/EXTENSION :n 
/FILE_PROTECTION:code 
/OWNER: [g,m] 
/MAXIMUM_FILES:n 
/PROTECTION :code 
/[NO] SHOW 

/LABEL :newvolumelabel 
/WINDOWS :n 

Command Qualifiers 

/ACCESSED :n 

Specifies the approximate number of directories that will be 
accessed simultaneously during the mount. Legal values for n 
range from 1 through 127. F11ACP maintains a list of most 
recently used directories. The value specified for /ACCESSED 
sets the number of entries in this list. 

In general, directory operations can be significantly speeded up 
by increasing this value. If a directory appears in the list, no 
disk I/O is required to find the directory in the MFD. In 
addition, directory operations take place without the necessity 
of reading the directory file header. Note that increasing the 
/ACCESSED value increases the amount of system pool used. 

/DENSITY:arg 
800 
1600 
6250 

Alters the /DENSITY value established when the volume was 
initialized. See the description of the /DENSITY qualifier under 
INITIALIZE (Section 5.8) for more information. 

/EXTENSIONS 

Specifies the number of blocks by which a file will be extended 
if it has exhausted its space allocation. n can be from 1 
through 127. The default is set by your system manager. 
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/FILE_PROTECTION:code 

Specifies the protection for new files created on the volume. 
See Section 4.1.5 for more information on file protection. 

/OWNER: [g,m] 

Specifies the owner of the volume. See Section 5.1.4 for more 
information. 

/MAXIMUM_FILES:n 

Specifies the maximum number of files permitted on the volume. 
This value must be greater than the maximum value on the current 
volume. See the discussion of /MAXIMUM_FILES under MOUNT for 
more detailed information on the maximum number of files 
permitted on various media. 

/PROTECTION :code 

Specifies the volume protection for the volume. See Section 
4.1.5 for more information on volume protection. 

/[NO] SHOW 

Specifies that the information about the volume whose home block 
is being updated is to be displayed on your terminal. /NOSHOW is 
the default. 

Here is the display format for disks and other random-addressable 
devices : 

Volume Information 

Class: Files-11 or Foreign 

Device: ddnn: 

Volume label: label 

Pack Serial: serial number supplied by manufacturer 

Owner: [g/m] 

Protection: code 

Default: code 

Processor : acpname 

The owner field indicates the owner of the volume. The UIC must 
be matched for protection checks for owner privileges. The owner 
UIC can be changed with the /OWNER qualifier. See Sections 5.1.3 
and 4.1.5 for more information. Protection indicates volume 
protection; Default indicates file protection. 

/LABEL :new volumelabel 

Permits you to change the volume label. Volume labels can be as 
many as 12 characters. See the discussion of volume labels under 
MOUNT (Section 5.6) for more information about volume labels and 
which characters can be included. 

/WINDOW :n 

Specifies the default number of mapping pointers to be allocated 
for file windows when the file is accessed. A file window 
consists of a number of mapping pointers stored in memory when 
the file is opened. Legal values for n range from 1 through 127. 
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Notes 

INITIALIZE/UPDATE invokes the HOME utility. See the 
RSX-11M/M-PLUS MCR Operations Manual . 

You should not use INITIALIZE/UPDATE without a good understanding 
of the Files-11 disk volume structure and a clear idea of the use 
the system makes of the values in the volume home block. For 
more information, see the IAS/RSX I/O Operations Reference 
Manual . ~ 

Error Messages 

INITIALIZE/UPDATE shares many error messages with INITIALIZE. 

<bell>*** ATTENTION*** <bell> 

This volume is operating with a replacement home block. 

Please take the action outlined in the documentation. 

Explanation: The HOME utility could not ensure that a good home 
block will be written on the volume, so it has placed an 
alternate home block on the first free block on the MOUNT search 
path. The new home block is not allocated to or mapped by any 
file. 

User Action: Copy the volume using BACKUP (BRU) or DSC before 

initiating any further operations. Otherwise, the replacement 

home block could be destroyed, making the data on the volume 
unrecoverable. 

INI — Failed to find home block 

Explanation: HOME could not locate the home block of the volume. 

User Action: Reenter the command, including /SHOW to determine 
whether it is a foreign volume or not. See your system manager 
for further help. 

INI — Failed to place alternate home block 

Explanation: When HOME cannot ensure that a good home block will 
be written back to the volume, it attempts to place an alternate 
home block on the first free block of the MOUNT search path. 
This message indicates the attempt failed. 

User Action: The message may indicate a hardware problem, most 
commonly that the device is write-locked . See your system 
manager. 

INI — MXF less than or equal to the existing value 

Explanation: The value specified in the /MAXIMUM_FILES qualifier 
was less than or equal to the value already specified for the 
volume. 

User Action: Reenter the command specifying a /MAXIMUM FILES 
value larger than the current one. ~ 
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5 . 9 BACKUP 

BACKUP backs up and restores Files-11 volumes. It transfers files 
from a volume to a backup volume and retrieves files from the backup 
volume. 

The data is directed to a volume (or volumes) during a backup 
operation. More than one backup set can be contained on a tape or 
disk, or a backup set can extend over several tapes or disks. 



Format 



BACKUP [/qualifiers] 

From? sourceddnn: [f ilespec[s] ] 

To? destinationddnn : 

BACKUP [/qualifiers] sourceddnn: [filespec [s] ] destinationddnn: 

Command Qualifiers 

Group 1: Selective Backup and Restore 

/CREATED: BEFORE: (dd-mmm-yy nn :mm) 

AFTER: (dd-mmm-yy nn:mm) 
/EXCLUDE 
/IMAGE :arg 

SAVE 

RESTORE 
/NEW VERSION 
/MODIFIED:BEFORE: (dd-mmm-yy nn:mm) 

AFTER: (dd-mmm-yy nn :mm) 
/[NO] REPLACE 

Group 2: Initialization 

/INITIALIZE 
/BAD_BLOCKS:arg 

AUTOMATIC 
MANUAL 
OVERRIDE 
/ACCESSED :n 
/EXTENSIONS 
/HEADERS :n 
/MAXIMUM_FILES:n 
/INDEX:arg 

BEGINNING 

MIDDLE 

END 

n 
/FILE_PROTECTION:code 
/WINDOWS:n 
/SAVE SET: name 
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Group 3: Tape Control 

/APPEND 
/DENSITY:arg 

800 

1600 

6250 
/ERROR_LIMIT:n 
/LENGTH :n 
/REWIND 
/LABEL :TAPE:fileset-ID 

Group 4: Verification 

/COMPARE 
/VERIFY 

Group 5: Display 

/[NO] LOG 
/LIST 

Group 6: Disk Processing 

/DIRECTORY 

/LABEL : INPUT : volumelabel 

/NOINITIALIZE 

/MOUNTED 

/[NO] PRESERVE 

/LABEL : OUTPUT : volumelabel 

Parameters 

sourceddnn: 

Specifies the name of the device on which the input volume 
containing the data to be transferred has been placed. 

For tapes and disks, if you are using the /IMAGE qualifier, you 
may specify in the following format, more than one input device 
for tapes and disks: 

> BACKUP MMO! > MM1 I , HM2: 
or 

> backup duo: , nun , DU2: 

You can specify as many as eight drives on each command, but you 
can specify a particular tape or disk drive only once. 

destinationddnn : 

Specifies the name of the device on which the output volume to 
which data is being transferred has been placed. 

For tapes and disks (if you are using the /IMAGE qualifier), you 
can specify more than one output device separated by commas, as 
described above. 
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f ilespec 

Indicates the file specification used to select particular files 
or categories of files to be backed up or restored. 

A filespec takes the form: 

[g,m] filename. typ;version 

You can specify as many as 16 filespecs per command. 

Files can be backed up or restored selectively by UFD, file name, 
file type, or version number. Note, however, that BACKUP does 
not accept or -1 as version numbers. 

When you enter a command without a file specification, all the 
files on the input volume are copied to the output volume. 

Any filespec field that is not specified is taken as a wildcard. 
If you do not specify version number, all versions will be 
assumed; if you specify only type, all files of all names and 
all versions of that type will be assumed; and so forth. 

Command Qualifiers 

Unless otherwise noted, the defaults for these qualifiers are the 
same as the equivalent attributes of the input volume. 

RftOKTJP provides six groups of command qualifiers: 

• Selective Backup and Restore 

• Disk Initialization 

• Tape and Disk Control 

• Verification 

• Display 

• Disk Processing 

Group 1: Selective Backup and Restore 

/CREATED : BEFORE : arg 
AFTERrarg 

Specifies selection of files created before or after the date and 
time given by arg. 

The required date/time argument can be in several formats. You 
must specify either a date or a time or both. If you do not 
specify a date, the default is today. If you do not specify a 
time, the default is now. Here are some examples: 

/BEFORE: 31-JUL-82 

/AFTER: 14:00 

/BEFORE: (l-APR-82 12:00) 

/AFTER: (1-APR-S2 12:00) 

/BEFORE: 4/1/82 

/AFTER: (4/1/82 12:30) 
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Note that if you wish to enter both a date and a time, you must 
use the parentheses. These formats are used wherever you specify 
a date or a time or both in a BACKUP command. 

/EXCLUDE 

Specifies that all files specified with the source device are to 
be excluded from the backup or restore operation, instead of 
included in it. For example, the command 

>BACKUP/EXCLUDE HBO : C306 » 63* , * HfiOI 

transfers all files except those in the UFD [306,6], 

/IMAGE :arg 
SAVE 
RESTORE 

Specifies that you want to do a multiple disk-to-disk backup or 
restore operation. 

If you want to do a backup operation, you must use /IMAGErSAVE 
when you create the backup file that represents the image copy of 
the input disk or disks. For example, this qualifier must be 
used when you copy a large disk to several small disks, or if you 
copy several small disks to a mounted large disk. 

If you are doing a restore operation, you must use /IMAGE : RESTORE 
if you are restoring from a backup file that represents the image 
copy of the original disk. 

/NEW_VERSION 

Specifies that a new version of the file be created in the event 
of conflicts that occur during restore operations and during 
backups to a mounted disk when using the /IMAGE:SAVE qualifier. 
Compare with /REPLACE. 

/MODIFIED: BEFORE :arg 
AFTER :arg 

Specifies selection of files modified before or after the 
specified date or time, or both. 

The required date/time argument can be in several formats. You 
must specify either a date or a time or both. If you do not 
specify a date, the default is today. If you do not specify a 
time, the default is now. Here are some examples: 

/BEFORE: 31-JUL-82 

/AFTER: 14: 00 

/BEFORE; (l-APR-8 2 12:00) 

/AFTER: (l-APR-82 12:00) 

/BEFORE: 4/1/82 

/AFTER: (4/1/82 12:30) 

Note that if you wish to enter both a date and a time, you must 
use the parentheses. These formats are used wherever you specify 
a date or a time or both in a BACKUP command. 
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/[NO] REPLACE 

Specifies whether or not files from the input volume should 
replace files having identical file specifications on the output 
volume. 

A conflict occurs when a file on the input volume and a file on 
the output volume have identical file specifications. The 
default qualifier /NOREPLACE resolves that conflict by keeping 
the file on the output volume rather than replacing it with that 
on the input volume. A message informs you that the file has not 
been superseded. /REPLACE resolves the conflict by deleting the 
file on the output volume and replacing it with the file being 
restored from the input volume. 

Group 2: Initialization 

/INITIALIZE 

/INITIALIZE specifies that you wish to initialize the output disk 
before proceeding with the data transfer. You must specify this 
qualifier if you wish to use any of the other initialization 
qualifiers discussed here. If you do not specify this qualifier, 
but specify other initialization qualifiers, you will be asked by 
a prompt whether you wish to initialize before proceeding or not. 
The default is /NOINITIALIZE. See the discussion in Group 6. 

See Section 5.8 for a description of INITIALIZE and its 
qualifiers. 

/BAD_BLOCKS:arg 

AUTOMATIC 

MANUAL 

OVERRIDE 

Enters the locations of bad blocks on the volume being 

initialized. See Chapter 6 of the RSX-11M/M-PLUS Utilities 

Manual for more information on BAD, the Bad Block Locator 
Utility. 

/BAD_BLOCKS : AUTOMATIC 

Specifies that bad-block information for the volume be determined 
automatically from the file BADBLK.SYS, created by the BAD 
utility. This is the default. 

/BAD: AUTOMATIC is the default. 

/BAD_BLOCKS : MANUAL 

Specifies that bad-block information for the volume is to be 
entered manually. 

/BAD_BLOCKS : OVERRIDE 

This qualifier applies only to last-track devices. It makes the 
disk appear not to have bad-block information written in the last 
track, even if this information is actually present. 
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/ACCESSED :n 



Specifies the default number of File Control Blocks per volume to 
be kept in memory by the ACP. See the description of the 
/ACCESSED qualifer to MOUNT (Section 5.6) for more information. 



/EXTENSION :n 



Specifies the number of blocks by which the file will be extended 
when its allotted space is exhausted. 

/HEADERS :n 

Specifies the number of file headers to be allocated initially in 
the index file. 

The five system files (INDEXF.SYS, BITMAP. SYS, CORIMG.SYS, 
BADBLK.SYS, and 000000. DIR) are not included in the value for n. 

The default value for n is proportional to the capacity of the 
magnetic medium. See the description of /HEADERS in Section 5.8 
for information on the different magnetic media. 

,/MAXIMUM_FILES:n 

Specifies the maximum number of files permitted on the volume. 

The value of n includes the five system files. The value of n 
must be less than or equal to the maximum value of n given in the 
description of /MAXIMUM_FILES in Section 5.6. The description 
also includes the default value of n for each device. 

/INDEX:arg 

BEGINNING 

MIDDLE 

END 

n 

Specifies the location of the index file on the volume. This 
qualifier forces a specified location for the index file, the 
Master File Directory, and the storage allocation file. This is 
usually done to minimize access time. 

Four possibilities are available for the argument field: 

BEGINNING The beginning of the volume. This is the default 
for tapes and DECtapes. 

MIDDLE The middle of the volume. This is the default for 
disks. 

END The end of the volume. 

n Logical block n. 

The default position is the position of the file on the input 
volume. 
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/FILE_PROTECTION: (code) 

Specifies the default protection for all files created on the 
volume being initialized. See Section 4.1.5 for more information 
on file protection. 

Default system protection code: 

(SYSTEM :RWED, OWNER :RWED, GROUP :RWED, WORLD :R) 

The default protection code is the protection code of the input 

VOlUIRS 

/WINDOWS :n 

Specifies the number of mapping pointers to be allocated for file 
windows. A file window consists of a number of mapping pointers 
stored in memory when the file is opened. 

The default is the number of mapping pointers on the input 
volume. 

See the discussion of the /WINDOWS qualifier in Section 5.6 for 
more information. 

/SAVE_SET:name 

Specifies the name of the backup set to be placed on tape or 
disk. For tapes and unmounted disks, the default name is the 

volume name for the disk being backed up. This name can be up to 

12 characters long. For an image backup or restore operation to 

a mounted input or output disk, you can specify the full backup 

set file name with /SAVE_SET. If you do not specify a file name, 
the default name is [0, 0]BACKUP.SYS. 

When you use /SAVE_SET with an output volume, the backup set name 
becomes the name of the backup set being placed on the output 
volume. You can place multiple backup sets on a single volume. 

When you apply /SAVE_SET to an input tape volume, BACKUP searches 
the first tape for the specified backup set name. If you do not 
specify a backup set name with the input volume, when you do a 
restore operation BACKUP restores the first backup set it finds 
on the tape. You can restore several sequential backup sets from 
the same device without rewinding the tape between operations. 
BACKUP does not rewind the first device in a backup set unless 
you specify the /REWIND qualifier. 

When you apply /SAVE_SET to an input disk volume, BACKUP searches 
the entire disk for each backup set you specify. Each backup set 
is then restored in the order in which you provided the backup 
set names of the backup set names you provided. 
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Group 3: Tape and Disk Control 
/APPEND 

Appends new data to a tape or disk that already contains one or 
more backup sets. If the tape is not positioned at the 
beginning, /APPEND causes output to be written where the tape is 
currently positioned. If you want to start writing at logical 
end-of-tape, you must specify /APPEND/REWIND, which rewinds the 
tape and then spaces forward to the end of the volume. 

If the output device is a disk, and you are using the /IMAGE 
qualifier, /APPEND causes BACKUP to check the container file 
header for the logical end-of-file on the output disk. BACKUP 
then starts writing at the logical end-of-file. 

You cannot use the /APPEND qualifier during a backup operation to 
a mounted disk. 

/DENSITY:arg 
800 
1600 

6250 

Specifies the density in bits per inch (bpi) for the medium 
loaded on the device. See Section 5.6 for a list of acceptable 
densities for DIGITAL devices. 

The default is 800 bpi. 

/ERROR_LIMIT:n 

Specifies the number of nonfatal I/O errors that BRU tolerates on 
tape reads before terminating execution. 

The default value for n is 25. 

/LENGTH :n 

Specifies the length of the output tape in decimal feet. You may 

want to use this qualifier when you know that the last part of a 

tape is defective and must not be used. You can specify a 

shorter length and ensure that you do not write on that part of 
the tape. 

The default length is the physical length of the output tape. 



Rewinds the first tape of a tape set before executing the command 
line. 

See /APPEND for further information on /REWIND. 

/LABEL :TAPE:fileset-ID 

Specifies a 6-character ANSI fileset-ID. On output operations 
this ID is written on the tape. On input operations the ID is 
compared with the ID already on the input tape to ensure that you 
have mounted the correct tape. 
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Group 4: Verification 

The following qualifiers allow you to verify the accuracy of data 
transfers. 

/COMPARE 

Compares the data on the output volume to the data on the input 
volume and reports any differences. /COMPARE does not copy any 
data. See /VERIFY. 

You must compare equivalent volumes. You can assure that the 

volumes are equivalent by including the /COMPARE qualifier in a 

command that is otherwise identical to the BACKUP command that 
was entered when the output volume was created. 

The restriction does not apply to the / [NO] INITIALIZE and 
/COMPARE qualifiers. 

/VERIFY 

Copies data from the input volume to the output volume, then 
performs a compare operation, and reports any differences. 

Group 5: Display 

The following qualifiers display information about the data 
transferred. 

/[NO] LOG 

Displays at your terminal the UFD and file name of each file 
being backed up or restored. /NOLOG is the default. 



/LIST 

Displays at your terminal the backup set names or files on the 
specified tape or disk volume. In a multivolume tape set, the 
directory is on the first tape of a set. In a multivolume disk 
set, the directory is on the first disk of the set. See the 
example. 

Group 6: Disk Processing 

The following qualifiers allow you to control the way the 
operating system manages disk data transfer operations. 

/DIRECTORY 

Directs BACKUP to create UFDs (if they do not already exist) on a 
mounted output volume, then copy into the UFDs the files from the 
same UFD on the input volume. If you do not specify /DIRECTORY, 
BACKUP does not copy the file. /DIRECTORY is used only with the 
/NOINITIALIZE qualifier. 

/LABEL : INPUT : vol umelabel 

Specifies the volume label of the input disk. This is not a 
required parameter; if you specify it, however, BACKUP checks 
the volume label. 



5-68 



HANDLING DEVICES AND VOLUMES 



^^0 f^t ^^f i^k. ^^0 ^l l ^^# ^J 1 1 1 I 



/NOINITIALIZE 



Specifies that you do not want to initialize the output disk, as 
it already contains a Files-11 structure and is mounted as a 
Files-11 volume. 



/MOUNTED 



Allows you to back up files from a disk that is mounted as 
Files-11. Transfers are faster from an unmounted volume. 

/[NO] PRESERVE 

/NOPRESERVE specifies that you do not want BACKUP to preserve 
file identifiers during a disk-to-disk transfer. The default is 
/PRESERVE. 

/LABEL : OUTPUT : volumelabel 

Specifies a volume label for the output disk. 

The default label is the label of the input volume. 
Examples 

>BACKUP/LABEL: INPUT* RANDOM/SAVE. SET* 19 JUL82 
From? DKOJ 
To: mmo: 

BAG - Star-tins tape 1 on MMO: 

BAC - End of tspe 1 on HMO I 

BAC - Completed 

This example transfers all files on the RK05 disk labeled RANDOM 
to the tape mounted on MMO:. The backup set name 19JUL82 
identifies the data written on the output tape. 

>BACKUP/REWIND/SAME_SET:18JUL82/N0 INITIALIZE MMO! Di-lC* 

This example rewinds the tape on drive MMO:, then locates the 
backup set with the name 18JUL82 (there may be more than one 
backup set on a tape) and transfers all files in the backup set 
to DM0: which is mounted and has a Files-11 structure. The 
/NOINITIALIZE qualifier instructs BACKUP not to initialize DM0:. 

>BACKUP/LIST mot 

MOL1 18JUL82 INPUT! 18-JUL.--82 
VOL!. BACKUP2 INPLTl- 1 ? -JUL --B2 
V0L1 19JUL82 RANDOM 1.9 -JUL-Si' 

This example shows a directory of a tape volume. It displays the 
tape volume number, VOLl, the names of three volumes, and three 
backup sets contained on the tape. 
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BACKUP can also be used to display the names of the files in a 
given backup set by specifying the backup set name along with the 
/LIST qualifier, as in the following example: 

>BACKUP/SAVE..SETil9JLIL82/LIST HMO J 

V0L1 19JUL82 RANDOM 19-JUL-82 23:3?: 11 

C303»13D 

27DECE.LSTS1 

ASTCRSH.MACJ2 

APNDXC.TXT 5 1 

X * MAC ? 1 

X.0BJJ1 

X.TSK5 1 

X.MAPJ1 

C306j6j 

27DECE.CBA* 1 

RSX11M.STBJ3 

BAG - Completed on MHOt 

Notes 

The BACKUP command invokes BRU, the Backup and Restore Utility. 
For more information on BRU, see Chapter 7 of the RSX-11M/M-PLUS 
Utilities Manual . 

You must specify either /INITIALIZE or /NOINITIALIZE. If you 
specify neither, BACKUP will ask if you wish to initialize the 
output device. 

BACKUP is not a privileged command, but you should not use it if 
you are not familiar with BRU. 

Error Messages 

For many nonfatal errors, BACKUP continues with the operation, 
but prints a warning message such as the following: 

BAC — *WARNING* APPENDING AT 800 BPI 

BAC — *WARNING* BOOT BLOCK IS BAD 

BAC — *WARNING* CANNOT RESTORE CONTIGUOUSLY 

BAC — *WARNING* EOT MARKER ERROR 

BAC — *WARNING* FILE IDS WILL NOT BE PRESERVED 

BAC — *WARNING* NONFATAL QUALIFIER CONFLICTS BEING IGNORED 

These and other warning messages are explained in Chapter 7 of 
the RSX-11M/M-PLUS Utilities Manual . 

BACKUP also issues purely informational messages such as the 
following: 

Completed 

Starting tape n on ddnn: 
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These messages require no response. 

BACKUP requests response from the user -with messages such as the 
following : 

Please answer Yes or No 

Mount another tape 

The following are the most common error messages from BACKUP. 
Other error messages are described in the RSX-1 1M/M-PLUS 
Utilities Manual . 

BAC — *FATAL*-Allocation for sys file exceeds volume limit 

Explanation: One of the five files created when a volume is 
initialized does not fit on the output disk. This message 
usually occurs when the output disk is smaller than the input 
disk. 

User Action: Reinitialize the disk using the /INDEX:BEGINNING 
qualifier to BACKUP or INITIALIZE to force the allocation to 
start at the beginning of the disk. You can also use the 
/MAXIMUM_FILES or /HEADERS qualifiers to reduce the size of 
INDEXF.SYS. 

BAC -- *FATAL*-Attach failed on ddnn: 

Explanation: BRU could not attach the specified device. 

User Action: Check to see if another task has the device 
attached, or if the device has a volume mounted on it. 

BAC — *FATAL*-Device conflict 

Explanation: Command specified both a tape and a disk drive as 
part of the input or output device specification. 

User Action: You can specify either a disk or a tape but not 
both. Check command for proper device names and reenter the 
command . 

BAC — *FATAL*-Device not in system 

Explanation: Command specified a device that is not part of the 
current system. 

User Action: Check command for proper device names and reenter. 

BAC — *FATAL*-Device not supported 

Explanation: Command specified a device that is not a tape or 
disk. 

User Action: Check command for proper device names and reenter. 



5-71 



HANDLING DEVICES AND VOLUMES 



SHOW ASSIGNMENTS 



BAC — *FATAL*-Disk read error 

Explanation: An unrecoverable read error occurred on the output 
disk. This error could be caused by an undetected bad block. 

User Action: Run BAD on the disk and then use BACKUP with the 
/BAD_BLOCKS: AUTOMATIC qualifier. 

BAC — *FATAL*-Disk write error 

Explanation: An unrecoverable write error occurred on the output 
disk. This error could be caused by an undetected bad block. 

User Action: Run BAD on the disk and then use BACKUP with the 
/BAD_BLOCKS: AUTOMATIC qualifier. 

BAC — *FATAL*-End of volume encountered. Backup set not found 

Explanation: The backup set specified for a restore operation is 
not on the tape volume. 

User Action: Mount the correct tape volume and retry the 
operation. 



5.10 SET AND SHOW 

yon can display assignments and set and display certain device 
characteristics. 



5.10.1 SHOW ASSIGNMENTS 

SHOW ASSIGNMENTS displays at your terminal all local and login 
logical-device assignments. Privileged users can display assignments 
from other terminals and global assignments. 

Logical-device assignments are established by ASSIGN, by SET DEFAULT, 
and by ACNT, the Account File Maintenance Program. 

Format 

SHOW ASSIGNMENTS [/qualifier] 

Command Qualifiers 

/LOCAL 

/GLOBAL 

/TERMINAL:ttnn: 

/LOGIN 

/SYSTEM (synonym for /GLOBAL) 

Parameters 

None. 
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Command Qualifiers 
/LOCAL 

Specifies that local and login logical assignments from your 
terminal are to be displayed on your terminal. This is the 
default. 



/GLOBAL 



Specifies that all logical assignments in the system, 
global assignments, are to be displayed on TI : . 
privileged qualifier. 



including 
This is a 



/TERMINAL :ttnn: 



Specifies that local and login assignments from terminal ttnn: 
are to be displayed on TI:. This is a privileged qualifier. 



/LOGIN 



Privileged qualifier included for completeness, 
terminals, this qualifier is the same as /LOCAL. 



For 



all 



Examples 



>3H0W 

Function? ASSIGNMENTS 

LPOt DK1J LOCAL TI - TTllt 

TPO: TT11J LOCAL TI - TT11! 

syo; DBi: LOGIN TI - ttii: 

This example shows the display for a user who has used ASSIGN to 
assign local logical names to a number of devices. These logical 
names can be used in place of the device names. The logical name 
is displayed on the left and the physical device name (or pseudo 
device name) is on the right. The type of assignment — LOCAL or 
LOGIN — is given, and the TI:. Output to LPO: will actually go 
to DK1:. In this case, the logical name takes the place of a 
physical device name. The user cannot direct output to physical 
LPO:. Output to TPO: will go to TT11:, which is TI:. In 
addition, the user has the login assignment of SYO: to DBI:. 
This means that DBI: is the default device for this user. 

>SH0I4 ASSIGNMENTS/LOCAL 
This example is the equivalent of the previous example. 

>SHOU ASSIGNMENTS/TERMINAL! TT37! 
MPOt SYO! LOCAL TI -- TT37! 
SYOt SYO! LOGIN TI - TT37! 

This example, which requires a privileged terminal, displays the 
logical assignments from terminal TT37:. This user has given the 
local logical name MPO: to the pseudo device, SYO:. The login 
assignment gives the login logical name SYO: to the pseudo 
device SYO:. SYO: is the name of the default device. 
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>SHOW ASSIGNMENTS/GLOBAL 
SYO: DBl: LOCAL TI - TT42: 
SYO: DBl: LOGIN TI - VT4: 
SYO: SYO: LOGIN TI - TT4: 
SYO: SYO: LOGIN TI - TT15: 



WKO: 


LBO: 


GLOBAL 


INO: 


SYO: 


GLOBAL 


EXO: 


SYO: 


GLOBAL 



This example, which requires a privileged terminal, displays all 
logical assignments for the entire system. 



5.10.2 SET DEVICE 

SET DEVICE establishes certain device attributes. With the exception 
of SET DEVICE:TI :/WIDTH:n, this is a privileged command. 



Format 



SET DEVICE 
Device? ddnn: 
Attribute? attribute 

SET DEVICE:ddnn:/attribute 

Device Attributes 

/ [NO] CHECKPOINT_FILE :n 
/[NO] LOWERCASE 
/[NO] PUBLIC 
/[NO] SYSTEM 
/WIDTH :n 

Parameter 

DEVICE:ddnn: 

Specifies the device for which attributes are to be set. Note 
that, when the one-line form of the command is used, the 
parameter is ddnn: preceded by a colon (:) at the end of the 
word DEVICE. 

Device Attributes 

/[NO]CHECKPOINT_FILE:n 

The /CHECKPOINT_FILE:n attribute sets aside n (decimal) blocks on 
the specified volume in [0,0]CORIMG.SYS, the checkpoint file. 
The volume must be in Files-11 format. Only one checkpoint file 
is permitted on each volume, but several volumes may have 
checkpoint files. The system searches for checkpoint files in 
the order they were created. If space is not available in the 
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first checkpoint file created (the primary file) , the system 
searches in the second file to be created, and so on. Checkpoint 
files can be allocated on volumes mounted on private devices. In 
general, the system should have checkpoint space equal to twice 
the total amount of memory that all running tasks are using. 

The /NOCHECKPOINT_FILE attribute makes the checkpoint file 
unavailable. If the specified file contains checkpointed tasks, 
the file is not deactivated until the tasks have returned to 
memory, but no new tasks will be checkpointed to the file. The 
checkpoint file is still on the volume but is zero blocks long. 

/[NO] LOWERCASE 

The /LOWERCASE attribute sets a terminal or line printer so that 
lowercase characters are not converted to uppercase for printing. 

The /NOLOWERCASE attribute sets a terminal or line printer so 
that lowercase characters are converted to uppercase for 
printing. This is the default. 

Nonprivileged users can use the SET TERMINAL/LOWERCASE command to 
set TI: in this fashion. 

/[NO] PUBLIC 
/[NO] SYSTEM 

The /PUBLIC attribute sets the device as a public device. This 
command also mounts the device. Public devices are accessible to 
all users. 

The /NOPUBLIC attribute removes the public status of a device. 
This is the default setting. 

/[NO] SYSTEM is a synonym included for VAX/VMS compatibility. 

Section 5.1.3 contains a discussion of public and private 
devices . 

/WIDTH :n 

Sets the size of a device's I/O buffer. The value of n (decimal) 
is the length in characters of a line on the device. 

For line printers, n must be greater than and not greater than 
255. The line-printer driver discards all characters in a record 
(line) that do not fit in the I/O buffer. 

For terminals, n must be greater than 2 and not greater than 255. 
The terminal driver does not discard excess characters, but puts 
them in a record of their own. That is, excess characters appear 
one line below the line in which they should appear. 

Nonprivileged users can set the width of their terminals using 
this command or SET TERMINAL/WIDTHrn. 
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Examples 



>SET 

Function? DEVICE 
Device? LP 1J 
Attribute? WIDTH: 80 



This example sets the I/O buffer size (line length) to 80 
(decimal) characters on the line printer LP1:. 



>SET DEVICE J LP1 J /LOWERCASE 

This example sets LPl: so that all lowercase characters sent to 
it will be printed in lowercase. The command must be issued even 
if the printer is controlled by the Queue Manager and has been 
initialized lowercase. 



>SET DEVICE I DB3i/CHECKP() f NT ...F I LE I 256 

This example creates a checkpoint file of 256 (decimal) blocks on 
DB3: . 

Notes 

SHOW DEVICES displays the attributes set by SET DEVICE. 

Error Messages 

SET — Feature not supported 

Explanation: The command specified an optional feature that was 
not incorporated into the system at system generation. 

User Action: See your system manager. 

SET — Pseudo device error 

Explanation: Command attempted to set a pseudo device public. 

User Action: A pseudo device cannot be set public. Retype 
command using physical device name. 

SET — Write check not supported 

Explanation: Command attempted to enable write-checking on a 
device that does not support it. 

User Action: Write-checking is not supported on magnetic tapes, 
RLOls, or RXOls. 
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5,10.3 SHOW DEVICES 

SHOW DEVICES displays information about the devices included in the 
system. 

Format 

SHOW DEVICES [/attribute] 

Device Attributes 

/dd[nn] : 

/[NO] PUBLIC 

/WIDTH :ddnn: 

/[NO]SYSTEM (synonym for /PUBLIC) 

Device Attributes 

If you do not include an attribute, SHOW DEVICES displays a list 
of all the devices on the system, including terminals and pseudo 
devices. 

/[NO] PUBLIC 
/[NO]SYSTEM 

Displays a list of all devices set (or not set) PUBLIC. 
/[NO] SYSTEM is a synonym included for VAX/VMS compatibility. 



/dd[nn] 



Displays information about all devices of a particular type on 
the system, dd: is the 2-letter device mnemonic terminated with 
a colon, which indicates the type of device controller. The 
display shows the devices under that type of controller by model 
name . 

The command SHOW DEVICES/dd [nn: ] is useful when you plan to 
allocate a drive, as it shows you which drives are available. 
Since the same controller may control devices whose disks are not 
interchangeable, a generic allocate (ALLOCATE DB) may allocate a 
device which cannot accept your disk. See examples. 

/WIDTH :ddnn: 

Displays the size of the I/O buffer (line length) for a 
particular device, including a terminal. 

Display Information 

The display from SHOW DEVICES can include a number of messages. 



ddnn: 



A device name in the first column indicates the device or pseudo 
device for which information is being displayed. A device name 
in the second column indicates a device to which the 
corresponding device in the first column has been redirected 
(logically assigned) . 
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TTnn; 



A terminal name in the second column, followed by the word 
PRIVATE, indicates that the device named in the first column has 
been allocated by the user logged on to the terminal in the 
second column. 

MOUNTED 

Indicates that the device is mounted. For privileged users, the 
message also includes the volume label. 

BUF = 

Indicates the line length (I/O buffer size) . 
PUBLIC 

Indicates that the device has been set public. 

If your command was SHOW DEVICES /PUBLIC, or /NOPUBLIC, the 
display is PUB=ddnn: or NOPUB=ddnn: 

TYPE= 

Indicates the device type by model name, for example, RL01, RX02. 
If you wish to display devices by type, use the 2-letter device 
mnemonic. 

MARKED FOR DISMOUNT 

Indicates that a mounted device has been marked for dismount, but 
that the dismount has not been completed, meaning that files are 
still open on the volume. The volume can be remounted while it 
is marked for dismount. 

OFFLINE 

Indicates that the system tables contain entries for the device, 
but that it is not included in the current configuration. 

[g,m] LOGGED ON 

Indicates that the user identified by [g,m] is logged on to the 
terminal . 

LOADED 

Indicates that a loadable device driver is currently loaded. 
UNLOADED 

Indicates that a loadable device driver is currently not loaded. 

SPOOLED 

Indicates that a device is under the control of the Queue 
Manager . 
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SHOW DEVICES (Cont) 



WCHK = 
NOWCHK= 

Indicates a device with wr i te-checking enabled or not enabled, 

Examples 



>SH0W 


DEVICES 




dbo: 


PUBLIC 


MOUNTED LOADED TYPE=RP06 


DB1 J 


PUBLIC 


MOUNTED LOADED TYPE=RP06 


DB2J 


PUBLIC 


LOADED TYPE=RP04 


DB3: 


PUBLIC 


MOUNTED LOADED TYPE=RP06 


dro: 


VT3J - 


PRIMATE MOUNTED LOADED TYPE 


dri: 


LOADED 


TYPE=RH03 


dko: 


LOADED 




lpo: 


DBO! Sf 


'DOLED LOADED 


LP It 


Deo: SPOOLED LOADED 


coo; 


T T o : 




ttc: 


LOADED 




"'. "i i : 


17, 40 3 


Clr 13 ■■ LOGGED ON LOADED 


112 1 


C7,40 3 


C14fl03 - LOGGED ON LOADED 


11 M 


L303i5: 


C303»53 - LOGGED ON LOADED 



=rmo: 



TT66! 


LOADED 




TT67: 


LOADED 




NI..0J 


LOADED 




mto: 


LOADED 




on: 


LOADED 




VT2S 


L" 1 i 1. 3 


111,13 


VT4? 


C303r53 


E303, 


T 1 : 






(JLOS 


tto: 




s p o : 


DBO*. 




lbo: 


DBO J 




syo: 


dbo: 





LOGGED ON LOADED 
LOGGED ON LOADED 



This example shows the display from SHOW DEVICES. All devices 
and pseudo devices are included. For terminals, the first [g,m] 
field is the login UIC and the second is the default UFD. The 
only information shown for pseudo devices is the name and the 
device to which they are redirected. Privileged users also see 
volume labels. 



>SH0W 


devices db: 


dbo: 


PUBLIC 


SB I 5 


PUBLIC 


DB2: 


PUBLIC 


DB3J 


PUBLIC 



MOUNTED LOADED TYPE=RP06 
MOUNTED LOADED TYPE=RP06 
LOADED TYPE=RP04 
MOUNTED LOADED TYPE=RP06 



This example displays information about all devices of the type 
DB:. The mnemonic (DBnn:) identifies the device controller and 
the model name (RP04) indicates the physical device type. RP04 
disks do not fit RP06 drives, even though the device controller 
is the same. 
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>shqw devices/public 
pub-dbo: 

PUB-DEI ! 
F'UB--EtB2i 
PUH==I>B3i 
PUB-- DSO J 

PU^BSl I 

PHB = L.P1 t 

This example displays information about all public devices. 
Public devices are accessible to all users, They may be mounted 
by any user to assure continued access to the volume mounted on 
the device. 

>show hem ice: : lpo : /width 
hi.ii-'=i..po:ooi32. 

■;>H0W Dt'JICcJ T Til J/WIDTH 
BUF-T1 11; 000 BO, 

This example displays the line lengths of a line printer and a 
terminal. The line length is determined by the size of the I/O 
buffer, which is established through SET DEVICE:ddnn:WIDTH. 
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CHAPTER 6 
PROGRAM DEVELOPMENT 

6.1 INTRODUCTION 

Program development on RSX-11M/M-PLUS is accomplished in four steps: 

1. Creating a program in a supported source language using an 
editor 

2. Compiling or assembling the source program to create a binary 
object file 

3. Turning the object file into a runnable task image using the 
Task Builder 

4. Running the program as a task on the system 

If you are not familiar with the rudiments of this process, see the 
Introduction to RSX-11M and RSX-11M-PLUS . 

To create a source program, you must be familiar with the 
file-creation facilities of the system discussed in Chapter 4 of this 
manual. You will also need knowledge of one of the programming 
languages available on your system. 

Commands described in this chapter on program development include 
commands directed to various language compilers or interpreters and 
the MACRO-11 Assembler, commands for maintenance of libraries used by 
programs, and the LINK command, which controls the operation of the 
Task Builder. 

RSX-11M/M-PLUS systems offer extensive program development facilities. 
These facilities are introduced in the RSX-11M/M-PLUS Guide to Program 
Development . This manual introduces the most important software tools 
used in program development and takes you through the program 
development process in considerable detail. 



6.2 SODRCE LANGUAGES 

RSX-11M and RSX-11M-PLUS support a number of programming languages, 
also called source languages. Not all of these languages are 
available on all systems, but all systems have one or more source 
languages available. 
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For each language or language group, there is a DCL command. The 
MACRO command gives access to the MACRO-11 Assembler. The BASIC 
command gives access to either the BASIC-11 interpreter or the 
BASIC-PLUS-2 interactive compiler. The FORTRAN command gives access 
to the FORTRAN-IV, FORTRAN- I V-PLOS , and FORTRAN-77 compilers. The 
COBOL command gives access to the PDP-11 COBOL and COBOL-81 compilers. 
The CORAL command gives access to the CORAL 66 compiler. 

Documentation is available for all DIGITAL-supplied languages included 
in your system. Your system may also have other languages not 
described here. See your system manager for information on the 
languages available at your installation. 

All systems include the MACRO-11 Assembler for processing MACRO-11 
source code. MACRO-11 is the assembly language for PDP-11 computers, 
but this language includes many features considered the province of 
high-level languages. MACRO-11 is named for its capacity to use 
macros, where a single line of code can stand for a long series of 
assembly-language instructions. 

Regardless of your usual programming language, you should look into 
MACRO-11. MACRO-11 is capable of doing anything that can be done on a 
PDP-11. All DIGITAL-supplied high-level languages have the means for 
incorporating MACRO-11 routines. Since the high-level languages are 
designed for use on computers from many different manufacturers, some 
functions that are difficult to achieve in a generalized high-level 
language may be easier to perform in MACRO-11, which is designed 
specifically for PDP-lls. 

In addition to the RSX-11M/M-PLUS Guide to Program Development , you 
should review the following manuals "Tor information on MACRO-11 
programming on RSX-11M or RSX-11M-PLUS: 

• PDP-11 MACRO-11 Language Reference Manual , which describes 
assembly-language programming. 

• IAS/RSX System Library Routines Reference Manual , which 
describes the routines used by system tasks on RSX-11M and 
RSX-11M-PLUS. These routines can be included in programs. 

• RSX-11M/M-PLUS Executive Reference Manual , which describes 
system directives and their processing. You can call 
Executive routines in your programs. 

• PDPll/xx Processor Handbook . Describes each PDP-11 model, 
including its instruction set. 



6.2.1 MACRO 

MACRO invokes the MACRO-11 Relocatable Assembler, which assembles one 
or more MACRO-11 source files into a single relocatable object module 
suitable for processing by the Task Builder. 

Format 

MACRO[/qualif ier [s] ] filespec [/qualifier [s] ] [ ,f ilespec[ ,s] ] 
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Command Qualifiers 

/[NO]CROSS_REFERENCE 
/DISABLE: (arg[,s] ) 

ABSOLUTE 

BINARY 

CARD_FORMAT 

GLOBAL 

LOCAL 

LOWERCASE 

REGISTERJ3EFINITIONS 

TRUNCATION 
/ENABLE: (arg[,s] ) 

ABSOLUTE 

BINARY 

CARD_FORMAT 

GLOBAL 

LOCAL 

LOWERCASE 

REGISTER_DEFINITIONS 

TRUNCATION 
/[NO]LIST[:f ilespec] 
/ [NO] OB JECT[ : f ilespec] 
/[NO]SHOW[: (arg[,s] ) ] 

ALL 

BINARY 

CALLS 

COMMENTS 

CONDITIONALS 

CONTENTS 

COUNTER 

DEFINITIONS 

EXPANSIONS 

EXTENSIONS 

LISTING_DIRECTIVES 

OBJECT_BINARY 

SEQUENCE_NUMBERS 

SOURCE 

SYMBOLS 
/[NO]WIDE 

File Qualifiers 

/LIBRARY 
/PASS:n 



Parameter 

f ilespec [s] 



Specifies input files for the MACRO-11 Assembler. These input 
files must contain MACRO-11 source code. Multiple filespecs must 
be separated by commas. Filespecs must include a file name. If 
no file type is given, the default file type (.MAC) is applied. 
If the parameter qualifier /LIBRARY is used, .MLB is the default 
file type. No wildcards are accepted by MACRO. 
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NOTE 

The MACRO-11 Assembler uses the name of 
the last file named in the command as 
the default name for output files. The 
last file named cannot be a library. 
All other language commands, and the 
LINK command, use the first file named 
in the command as the default name for 
output files. 

Command Qualifiers 

/[NO]LIST[:filespec] 

Specifies whether an assembly listing should be generated. The 
default is /NOLIST, meaning no assembly listing is generated. 

If you do not supply a file specification for this qualifier, the 
listing has a file name derived from the name of the last source 
file in the MACRO command with the file type .LST. If you wish 
the listing to have a different name, supply the name as an 
argument to the /LIST qualifier. If you do supply a name, the 
listing file appears in your directory but is not printed on the 
line printer. 

The /LIST qualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /LIST is used as a command qualifier, the listing 
file is placed in your directory and printed on the line printer. 
If /LIST is used as a filespec qualifier, the listing file 
appears in your directory but is not printed on the line printer. 

If your command line includes the /CROSS_REFERENCE qualifier, 
/LIST is implied and need not be specified. /CROSS_REFERENCE as 
a command qualifier causes the file to be printed on the line 
printer; /CROSS_REFERENCE as a filespec qualifier prevents the 
listing file from being printed. 

If your command line includes listing-control arguments to either 
/SHOW or /NOSHOW, /LIST is implied and need not be specified. 
/[NO] SHOW as a command qualifier causes the file to be printed on 
the line printer; /[NO]SHOW as a filespec qualifier prevents the 
listing file from being printed. 

The only time you need to use /LIST with /CROSS_REFERENCE or 
/[NO] SHOW is when you wish to give the listing file a filespec 
other than the default. In such cases, the position of the 
qualifiers in the command line has no effect; the listing file 
appears in your directory but is not printed on the line printer. 

See the examples. 
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/ [NO] OBJECT [ : f ilespec] 

Specifies whether an object module should be generated. The 
default is /OBJECT, meaning an object module is generated. If 
you do not supply a file specification, the object file has a 
name derived from the name of the last source file and the file 
type .OBJ. If you wish the object file to have a different name, 
give the name as an argument to the /OBJECT qualifier. 

You can name the object file after any of the source files listed 
in the MACRO command by using /OBJECT as a f ilespec qualifier. 
If used as a f ilespec qualifier, /OBJECT cannot take a f ilespec 
argument. 

The qualifier /NOOBJECT specifies that no object module is 
generated. You can use this qualifier if you wish to use other 
facilities of the assembler, to get an assembly listing, for 
instance, without doing the assembly. 

/ [NO] CROSS_REFERENCE 

Specifies whether a cross-reference listing should be generated 
and appended to the assembly listing. The default is 
/NOCROSS_REFERENCE . 

The cross-reference listing locates all user-defined and MACRO 
symbols that appear in the source program. 

When you specify this qualifier, you are also specifying the 
/LIST qualifier by implication. An assembly listing is 
generated. It appears in your directory and is also printed on 
the line printer. If you wish to change the name of the listing 
file, you must use /LIST with a file specification in addition to 
/CROSS_REFERENCE . 

/CROSS_REFERENCE as a command qualifier causes the file to be 
printed on the line printer; /CROSS_REFERENCE as a filespec 
qualifier prevents the listing file from being printed. See the 
examples and the discussion under /LIST. 

/ENABLE: (arg[,s] ) 
/DISABLE: (arg[,s] ) 

These qualifiers override the .ENABL and .DSABL assembler 
directives included in the source program being assembled. The 
•ENABL and .DSABL directives invoke or inhibit various aspects of 
the assembly. Table 6-1 summarizes the arguments to /ENABLE and 
/DISABLE and gives their MACRO-11 equivalents. There is a 
default setting for each of these directives, even if you do not 
specify them in your code or command line. 

These qualifiers affect the entire assembly. If, for example, 
your MACRO command includes the qualifier /ENABLE: LOWER CASE, the 
assembler does not convert any lowercase source "text to 
uppercase, regardless of any .DSABL LC or .ENABL LC directives in 
the source code. The same goes for /DISABLE:LOWER_CASE. All 
.ENABL or .DISABL LC directives are ignored. 
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If you specify only one argument to /ENABLE or /DISABLE, you need 
not include the parentheses, but if you have more than one 
argument, they must be separated by commas and enclosed in 
parentheses . 

Table 6-1 
The /ENABLE and /DISABLE Qualifiers 



Assembl 


y Functions Disabled by Default 


ABSOLUTE 


AMA 


Enabling this function causes 
relative mode addresses (mode 67) to 
be assembled as absolute addresses 
(mode 37) . 


BINARY 


ABS 


Enabling this function produces 
absolute binary output in Files-11 
format. 


CARD_FORMAT 


CDR 


Enabling this function causes source 
columns 73 and greater to be treated 
as a comment. 


LOCAL 


LSB 


Enabling this function permits the 
disabling or enabling of a local 
symbol block. 


LOWERCASE 


LC 


Enabling this function causes 
MACRO-11 to accept lowercase ASCII 
input. The default is to convert it 
to uppercase. 


TRUNCATION 


FPT 


Enabling this function causes 
floating-point truncation. The 
default is floating-point rounding. 


Assembl 


y Functions Enabled by Default 


REGISTER DEFINITIONS 


REG 


Disabling this function inhibits the 
normal MACRO-11 default register 
definitions. The default is R0=%0, 
R1=%1 . . . SP=%6,PC=%7. Under most 
circumstances, you should use these 
defaults . 


GLOBAL 


GBL 


Disabling this function causes 
MACRO-11 to treat all symbol 
references that are undefined at the 
end of Assembly Pass 1 as undefined 
symbols. The default is to treat 
all such symbols as global symbols. 
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/[NO]SHOW[: (arg[,s] ) ] 

These qualifiers override the .LIST and .NLIST assembler 
directives included in the source program being assembled. The 
.LIST and .NLIST directives control the content and format of the 
assembly listing. Table 6-2 summarizes the arguments to /SHOW 
and /NOSHOW and gives their MACRO-11 equivalents. There is a 
default setting for each of these directives, even if you do not 
specify them in your code or command line. 

These qualifiers affect the entire assembly. If, for example, 
your MACRO command includes the qualifier /SHOW: COMMENTS, the 
assembly listing includes all comments, regardless of any .NLIST 
COM or .LIST COM directives in the source code. The same goes 
for /NOSHOW: COMMENTS. All .LIST COM or .DISABL COM directives 
are ignored. 

If you specify only one argument to /SHOW or /NOSHOW, you need 
not include the parentheses, but if you have more than one 
argument, they must be separated by commas and enclosed in 
parentheses. 

/SHOW implies /LIST, but if you wish the listing file to have a 
name other than the default, you must still use /LIST. 

/SHOW as a command qualifier causes the file to be printed on the 
line printer; /SHOW as a filespec qualifier prevents the listing 
file from being printed. See the example and the discussion 
under /LIST. 



Table 6-2 
The /SHOW and /NOSHOW Qualifiers 



Listing 


Functions Disabled by Default 


EXPANSIONS 


ME 


Enabling this function causes 
MACRO-11 to include all macro 
expansions in the listing. 


BINARY 


MEB 


Enabling this function causes 
MACRO-11 to list only those macro 
expansions that generate binary 
code. This is a subset of 
EXPANSIONS. 


LISTING DIRECTIVES 


LD 


Enabling this function causes 
MACRO-11 to list all listing control 
directives without arguments, that 
is, those listing directives that 
alter the listing level count. 



(Continued on next page) 
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Table 6-2 (Cont.) 
The /SHOW and /NOSHOW Qualifiers 



Listing Functions Enabled by Default 



SEQUENCE NUMBERS 



COUNTER 



OBJECT BINARY 



EXTENSIONS 



SOURCE 



COMMENTS 



DEFINITIONS 



CALLS 



CONDITIONALS 



CONTENTS 



SEQ 



LOC 



BIN 



BEX 



SYMBOLS 



SRC 



COM 



MD 



MC 



CND 



TOC 



SYM 



Disabling this function suppresses 
the inclusion of sequence numbers in 
the listing. Sequence numbers are 
replaced by tabs. 

Disabling this function suppresses 
the location counter field and does 
not replace it with a tab. 

Disabling this function suppresses 
the listing of generated binary code 
and does not replace it with a tab. 

Disabling this function suppresses 
the listing of binary extensions, 
that is, all binary code that will 
not fit on the first line. This is 
a subset of OBJECT_BINARY. 

Disabling this function suppresses 
the listing of source lines. 

Disabling this function suppresses 
the listing of comments. This is a 
subset of SOURCE. 

Disabling this function suppresses 
the listing of macro definitions and 
repeat range expansions. 

Disabling this function suppresses 
the listing of macro calls and 
repeat range expansions. 

Disabling this function suppresses 
the listing of unsatisfied 
conditional coding. 

Disabling this function suppresses 
the listing of table of contents 
during assembly pass 1. The full 
assembly listing is still prepared 
during assembly pass 2. 

Disabling this function suppresses 
the listing of the symbol table 
resulting from the assembly. 
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/[NO]WIDE 



Specifies whether you wish the assembly listing in wide or narrow 
format. The default can be set by your system manager. As 
supplied, the default is /WIDE, also called line printer format. 
/NOWIDE is sometimes called teleprinter format. 



TTM directives 



This qualifier overrides any .LIST TTM or .NLIST 
included in your source program. 

Parameter Qualifier 

/PASS:n 

Specifies that the file thus qualified is only to be assembled 
during the pass specified. The assembler makes two passes; n 
can be either 1 or 2. 



/LIBRARY 



Specifies that the file thus qualified is a macro library. The 
default file type is .MLB. A user macro library file must be 
specified in the command line before any source files that use 
the macros defined in the library. A library may not be the last 
file named in the command line. Remember that the system macro 
library has the type .SML. If you are referencing this library, 
you must explicitly state the type. 



Examples 



> MACRO 
File? NOODLE 

This example assembles the source file 
relocatable object module named NOODLE. OBJ. 



NOODLE. MAC into 



> MACRO NOODLE 
This example is equivalent to the previous one. 

>MACR0 N00DLE»D00DLE,YANKEE 

This example assembles the source files NOODLE. MAC, DOODLE. MAC, 
and YANKEE. MAC into a relocatable object module named YANKEE. OBJ. 

>MACRO/LIST NOODLE 

This example assembles the source file NOODLE. MAC into the object 
file NOODLE. OBJ, and also produces an assembly listing, 
NOODLE. LST. The assembly listing appears in your directory and 
is also printed on the line printer. 
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>MACRO/LIST! PRINCE NOODLE 

This example assembles the source file NOODLE. MAC into the object 
file NOODLE. OBJ, and also produces an assembly listing named 
PRINCE. LST. The assembly listing appears in your directory and 
is printed on the line printer. 



>mac/list:ti: noodle 



NOODLE MACRO Ml 113 02-SEP-82 11 Ml. PAGE 1 



1 .TITLE NOODLE 

2 .LIST TTM 

3 . NLIST BEX 
4 

5 

6 i MACRO LIBRARY CALLS 

7 

8 .MCALL EXIT*SrQIOW*»DIR* 

9 



This example assembles the source file NOODLE. MAC into the object 
file NOOuLE.OBJ and types the assembly listing on your terminal. 
No permanent copy of the listing file is retained, nor does the 
listing appear on the line printer. 



>mac/object:rotini noodle 

This example produces an object file with the name ROTINI.OBJ. 

>MACR0 NO DLE /LIBRARY • ROTINI -SPIRE LL I ? SHELL 

This example assembles a concatenated object file named SHELL. OBJ 
from the source files NOODLE. MLB, ROTINI.MAC, SPIRELLI.MAC, and 
SHELL. MAC. 

>MACR0/N0SH0U J COMMENTS/WIDE NOODLE 

This example produces an object module and an assembly listing. 
Any .LIST or .NLIST directives with TTM or COM as arguments are 
ignored. The directives themselves appear in the listing, but 
they have had no effect. The listing produced by this command 
includes no comments and is in wide format. The listing is 
printed on the line printer and appears in your directory as 
NOODLE. LST. 
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>MACR0/N0SH0W J (COHMEr 



I * C ¥ D A kit 



iwiui^u 



This example produces an object module and an assembly listing. 
Any .LIST or .NLIST directives with COM, BIN, or ME arguments are 
ignored. The listing includes no comments and no binary code, 
but does include macro expansions. Observe the use of 
parentheses where two arguments are given for /NOSHOW and the 
lack of parentheses where only one argument is given for /SHOW. 



Notes 



You must be familiar with MACRQ-11 Assembly Language to use the 
MACRO command successfully. In particular, see the chapter on 
operating procedures in the PDP-11 MACRO- 11 Language Reference 
Manual . 



See also the chapter 



on 



assembler directives for 



information on the /[NO] SHOW and /ENABLE and /DISABLE qualifiers. 



6.2.2 BASIC 

BASIC invokes an interpreter or compiler for the BASIC language. 
BASIC stands for Beginners All-Purpose Symbolic Instruction Code. 

Format 

BASIC[/qualifier] [@filespec] 

Command Qualifiers 

/Bll 
/BP2 
/USING:userbasic 

Parameter 

@f ilespec 

Specifies an indirect command file that contains BASIC-PLUS-2 
commands. 

Command Qualifiers 

/Bll 

Specifies the BASIC-11 interactive language interpreter. Under 
this interpreter, programs are not compiled or task built. The 
BASIC-11 interpreter is a task that interprets and executes 
BASIC-11 instructions. 

BASIC-11 includes an immediate or "desk-calculator" mode. If 
your system includes BASIC-11, you should look into it even if 
you do not plan to program in BASIC-11. See the examples. 

BASIC-11 is compatible with Dartmouth BASIC. 

The BYE command causes an exit from BASIC-11. 
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/BP2 

Invokes the BASIC-PLUS-2 compiler, which is the default. The BP2 
compiler can create Task Builder Command and Overlay Descriptor 
Language (ODL) files and a listing file in addition to the object 
module file for the program it compiles. See Section 6.4 for 
information on how to use these files with the LINK command. 

The EXIT command or a CTRL/Z causes an exit from BASIC-PLUS-2. 

/USINGruserbasic 

Invokes an installed interpreter or compiler different from 
either of the DIGITAL BASIC systems discussed here. See your 
system manager for further information. 



Examples 



>BASIC/B11 

IAS/RSX BASIC V02-01 

READY 
BYE 



In this example, the user invoked the BASIC-PLUS-2 interpreter 
with the BASIC/Bll command. READY is the BASIC-11 prompt. The 



>BASIC 

PDP-11 BASIC-PLUS-2 V2.0 BL-00 

BASIC2 

EXIT 



In this example, the user invoked by default the BASIC-PLUS-2 
compiler. BASIC2 is the BASIC-PLUS-2 prompt. The EXIT command 
causes an exit from BASIC-PLUS-2 (as does CTRL/Z) . 

>BASIC/B11 

IAS/RSX BASIC V02-01 

READY 

PRINT <10+2>#(38*9)*<PI/3> 
4297.7 

READY 

10 FOR 1=1 TO 10 
20 PRINT (I*PI)/3 
30 NEXT I 

READY 
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RUN 

NQNAME 26-0CT-92 17:il!55 

1,0472 

2,0944 

3.14159 

4.18879 

5.23599 

6.28319 

7.33038 

8,3^758 

9.42478 

10.472 

READY 
BYE 



In this example, the user used the immediate mode of BASIC-11 
(without line numbers) to perform a calculation. Then, the user 
typed in a small program (with line numbers) to produce a table. 
This program can be saved; the immediate mode example cannot. 
BASIC-11 includes many mathematical functions and others can be 
defined . 



Notes 



See the BASIC documentation, if any, supplied with your system. 
Not all systems include BASIC. 



6.2.3 FORTRAN 

FORTRAN invokes a FORTRAN compiler. 

RSX-11M/M-PLUS systems may use two DIGITAL FORTRAN source language 
compilers: FORTRAN IV/IAS-RSX (commonly called FORTRAN IV), and 
FORTRAN-77. FORTRAN IV-PLUS is described in this section for those 
users who still have this compiler on their systems; however, 
FORTRAN-77 is superseding the FORTRAN IV-PLUS compiler. Since these 
compilers are optional software, your installation may have no FORTRAN 
compiler at all. 

Format 

FORTRAN r /mi a 1 ifiprtsll fi 1 osnoo r .q1 

Command Qualifiers 

/[NO] CHECK 
/CODErarg 

EAE 

EIS 

FIS 

THREADED 



6-13 



PROGRAM DEVELOPMENT 



FORTRAN (Cont.) 



/CONTINUATIONS:!! 
/[NO]DLINES 
/ [NO] EXTEND_SOURCE 
/FOR 
/F4P 
/[NO]F77 
/IDENTIFICATION 
/[NO] 14 

/[NO]LINE_NUMBERS 
/[NO] LIST[:f ilespec] 
/ [NO] MACHINE_CODE 
/[NO] MAP 

/ [NO] OBJECT [ : f ilespec] 
/[NO] SHAREABLE 
/SOURCE 

/[NO]STANDARD:arg 
ALL 
NONE 
SOURCE 
SYNTAX 
/[NO]TRACEBACK:arg 

ALL 

BLOCKS 

LINES 

NAMES 

NONE 
/USING: user compiler 
/[NO] VECTORS 
/[NO] WARNINGS 
/WORK_FILES:n 

Parameter 

f ilespec [ ,s] 

Specifies the file or files to be compiled. If you name more 
than one file, separate the filespecs with commas. 

Files input to any of the FORTRAN compilers must contain FORTRAN 
source language to match that compiler. In other words, the 
FORTRAN IV compiler works only on FORTRAN IV source code, and so 
forth. See the FORTRAN documentation supplied with your system 
for more information. 

The default file type for all FORTRAN compilers is .FTN. 

NOTE 

The FORTRAN compilers use the name of the first file 
named in the command as the default name for output 
files. Except for MACRO-11, all language commands and 
the LINK command use the first file named in the command 
as the default name for output files. 
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Command Qualifiers 
/FOR 

Specifies the FORTRAN IV compiler. This is the default for the 
FORTRAN command, so it is not necessary to use this qualifier. 

Your system must include the FORTRAN IV Object Module Library 
(OLB) and Object Time System (OTS) for this qualifier to work. 
Therefore, your system or library UFD must include the followinq 
files: 

FOROTS.OLB 
FOR.TSK 



/F4P 



Specifies the FORTRAN IV-PLUS compiler. The system must include 
the FORTRAN IV-PLUS Object Module Library (OLB) and Object Time 
System (OTS) for this qualifier to work. Therefore, your system 
or library UFD must include the following files: 

F4POTS.OLB 
F4P.TSK 

Please note that FORTRAN IV-PLUS has been superseded by 
FORTRAN-77. ~ ' ' 

/[NO]F77 

Specifies the FORTRAN-77 compiler. /NOF77 is the equivalent of 
/F4P. 

/[NO] CHECK 

The /CHECK qualifier specifies that you wish the compiler to 
check that all array references are within bounds. 

The default is /NOCHECK. 

This qualifier is for FORTRAN IV-PLUS and FORTRAN-77. 

/CODE:arg 
EAE 
EIS 
FIS 
THREADED 

The /CODE qualifier specifies that the code has certain 
characteristics. EAE means the code uses the Extended Arithmetic 
Element. EIS means that the code uses the Extended Instruction 
Set. FIS means the code uses the Floating Instruction Set; FIS 
also includes EIS. THREADED means the code is threaded. 

The /CODE qualifier is for FORTRAN IV only. 
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/CONTINUATIONS :n 

The /CONTINUATIONS qualifier specifies the maximum number of 
continuation lines permitted in the code. The value of n can be 
from through 99. The default is 5. 

The /CONTINUATIONS qualifier is for FORTRAN IV-PLUS and 
FORTRAN-77. 

/[NO]DLINES 

The /DLINES qualifier specifies that lines with a "D" character 

in column 1 are to be compiled. The default is /NODLINES, 

meaning these lines are treated as comment lines. Use this 
feature for debugging. 

The /DLINES qualifier is for FORTRAN IV-PLUS and FORTRAN-77. 
/ [NO] EXTEND_SOURCE 

The /EXTEND_SOURCE qualifier specifies that you wish the compiler 
to accept more than 72 columns of source input for each line. 
The default is /NOEXTEND_SOURCE, meaning the compiler reads only 
columns 1 through 72 and treats lines after that as comments. 

The /EXTEND_SOURCE qualifier is for FORTRAN IV only. 

/IDENTIFICATION 

The /IDENTIFICATION qualifier causes the compiler to print its 
identification and version number on your terminal. 

/[NO] 14 

The /I4 qualifier causes a two-word default allocation for 

integer variables. The default is /NOI4, meaning the compiler 

causes a single-word allocation for any integer variables not 

given an explicit length specification. 

/[NO]LINE_NUMBERS 

The /LINE_NUMBERS qualifier specifies that you wish the compiler 
to include Internal Sequence Numbers. Although these numbers 
create more object code and increase program execution time, they 
inform you which line caused your program to err, should it err. 
The default is /NOLINE_NUMBERS. 

The /LINE_NUMBERS qualifier is for FORTRAN IV only. 

/[NO] LIST[:f ilespec] 

Specifies whether a compiler listing should be generated. The 
default is /NOLIST, meaning no compiler listing is generated. 

If you do not supply a file specification for this qualifier, the 
listing has a file name derived from the name of the first source 
file in the FORTRAN command with the file type .LST. If you wish 
the listing to have a different name, supply the name as an 
argument to the /LIST qualifier. If you do supply a name, the 
listing file appears in your directory but is not printed on the 
line printer. 
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The /LIST qualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /LIST is used as a command qualifier, the listing 
file is placed in your directory and printed on the line printer. 
If /LIST is used as a filespec qualifier, the listing file 
appears in your directory but is not printed on the line printer. 
If /LIST is used as a filespec qualifier, the listing file takes 
the name of that file. 

The /MACHINE_CODE, /MAP, and /SOURCE, qualifiers all affect the 
contents of the compiler listing file. 

/ [NO] MACHINE_CODE 

The /MACHINE_CODE qualifier specifies that you wish the compiler 
listing to include binary machine code and diagnostics. The 
default is /NOMACHINE_CODE. 

/MACHINE_CODE implies /LIST. You do not need to include the 
/LIST qualifier unless you wish to use it to establish a name for 
the listing file different from any of the file names included in 
the compilation. 

The /MACHINE_CODE qualifier behaves in a different manner 
depending on whether it is given as a command qualifier or a 
filespec qualifier. If /MACHINE_CODE is used as a command 
qualifier, the listing file is placed in your directory and 
printed on the line printer. If /MACHINE_CODE is used as a 
filespec qualifier, the listing file appears in your directory 
but is not printed on the line printer. If /MACHINE_CODE is used 
as a filespec qualifier, the listing file takes the name of that 
file. 

/[NO] MAP 

The /MAP qualifier specifies that you wish the compiler listing 
to include a storage map and diagnostics. 

/MAP implies /LIST. You do not need to include the /LIST 

qualifier unless you wish to use it to establish a name for the 

listing file different from any of the file names included in the 
compilation. 

The /MAP qualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /MAP is used as a command qualifier, the listing 
file is placed in your directory and printed on the line printer. 
If /MAP is used as a filespec qualifier, the listing file appears 
in your directory but is not printed on the line printer. If 
/MAP is used as a filespec qualifier, the listing file takes the 
name of that file. 

/ [NO] OBJECT [ : f i lespec] 

Determines whether or not an object module is generated by the 
compiler. The default is /OBJECT, which does create a module. 
The default name of the object file created by FORTRAN is the 
name of the last-named source file with the file type .OBJ. If 
you wish the object file to have a different name, supply the 
name as an argument to the /OBJECT qualifier. 
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/NOOBJECT specifies that no object module is created. You can 
use the /NOOBJECT qualifier to get a compiler listing file to 
check for errors without generating object code. 

/SHAREABLE ■ "'^ V> ": , ' : 7.'-i •- 1 :'" : ' ■■■*.,■ • C ''" ■ /li. ''"'' -^Z. 7 ^ 

The /SHAREABLE qualifier states that •/on wish the compiler to 
generate pure cud<i and pure data sections as read-only. This 
takes advantage of code sharing in multiuser tasks on 
RSX-llM-m.tJS systems. ' ' 

-ni.-, q-ialificr. ie toe i.-'OSTKAN rv-PLUS and FORTRAN-?"? only. 
/SOURCE 

The /SOURCE qualifier specifies that you wish the compiler 
listing to include the source code. 

/SOURCE implies /LIST. You do not need to include the /LIST 

qualifier unless you wish to use it to establish a name for the 

listing file different from any of the file names included in the 
compilation. 

The /SOURCE qualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /SOURCE is used as a command qualifier, the 
listing file is placed in your directory and printed on the line 
printer. If /SOURCE is used as a filespec qualifier, the listing 
file appears in yout directory but is not pnntSu on mc j.ine 
printer. If /SOURCE is used as a filespec qualifier, the listing 
file takes the name of that file. 

/[NO] STANDARD :arg 
ALL 
NONE 
SOURCE 
SYNTAX 

The /STANDARD qualifier directs the compiler to look in your 
source code for extensions to ANSI standard (X3. 9-1978) FORTRAN 
at the full-language level. If the compiler finds extensions, it 
flags them and produces informational diagnostics. 

Although PDP-11 FORTRAN-77 conforms to the ANSI FORTRAN standard 
at the subset level, the compiler flags only those features that 
are extensions to the full language. See Appendix G of the 
PDP-11 FORTRAN-77 User's Guide for a list of flagged extensions. 

The ALL argument produces informational diagnostics for all 
detected extensions. 

The NONE argument produces no informational diagnostics. 

The SOURCE argument produces informational diagnostics for 
lowercase letters and tab characters in the source code. 

The SYNTAX argument is the same as /STANDARD with no argument. 

The default is /NOSTANDARD. 

The /[NO] STANDARD qualifier is for FORTRAN-77 only. 
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/[NO] TRACEBACK: a rg 
ALL 

BLOCKS 
LINES 
NAMES 
NONE 

/TRACEBACK controls the amount of extra code included in the 
compiled output for use by the OTS during error traceback. This 
code is used in producing diagnostic information and in 
identifying which statement in the FORTRAN source program caused 
an error condition to be detected during execution. This 
qualifier is for FORTRAN IV-PLUS and FORTRAN-7 7. 

The ALL argument states that error traceback information is to be 
compiled for all source statements, and function and subroutine 
entries. 

The LINES argument is the same as ALL. 

The BLOCKS argument states that traceback information is to be 
compiled for subroutine and function entries and initial 
statements in sequences called blocks. This is the default. 

The NAMES argument states that traceback information is to be 
compiled only for subroutine and function entries. 

The NONE argument states that no traceback information is to be 
produced. 

/USING: user compiler 

Invokes a FORTRAN compiler other than one of the DIGITAL-supplied 
compilers. 

/[NO] VECTORS 

The /VECTORS qualifier specifies that you wish vectored arrays. 
This increases the size of object modules but decreases execution 
time. The default is /VECTORS. 

The /VECTORS qualifier is for FORTRAN IV only. 

/[NO] WARNINGS 

The /WARNINGS qualifier specifies that you wish the compiler to 
issue warning diagnostics. This is the default. 

The /WARNINGS qualifier is for FORTRAN IV only. 

/WORK_FILES:n 

The /WORK_FILES qualifier specifies the number of temporary 
on-disk files you wish used during the compilation, n can be 
from through 3; the default is 2. Increasing the number of 
work files increases the maximum possible size of your program 
but decreases the speed of compilation. 
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Examples 



> FORTRAN 
File<s>? CODY 



This example compiles the FORTRAN IV source file CODY.FTN into 
the relocatable object module CODY. OBJ. 



>F0RTRAN/F77 
FileCs)? CODY 



This example compiles the FORTRAN-77 source file CODY.FTN into 
the relocatable object module CODY. OBJ. 



>F0R SAX, CODY' » GERARD 

The FORTRAN IV compiler compiles the source files SAX.FTN, 
CODY.FTN, and GERARD. FTN into a relocatable object module named 
SAX. OB J. The commas (,) cause the three source files to be 
concatenated. 



>F0R/LIST CODY 

This example creates an object module, CODY. OBJ, and a compiler 
listing, CODY.LST, from a source file, CODY.FTN. The listing 
file and object module appear in youi UFD and the listing tile is 
printed on the line printer. 



> for/list: copy gerard 

This example creates the object module GERARD. OBJ and a compiler 
listing, CODY.LST, from the source file, GERARD. FTN. Both output 
files appear in your UFD, but the listing file is not printed on 
the line printer. To print this file, issue a PRINT command. 



>for/list:ti: cassady 

This example creates the file CASSADY. OBJ and prints the assembly 
listing on your terminal. No listing file is printed on the line 
printer or retained in your directory. 



>F0R/F77/0BJ J CASSADY STELLA 

The FORTRAN-77 compiler creates an object module, CASSADY. OBJ, 
from the source file STELLA. FTN. 



> FORTRAN/LIST CODY. LOWELL 

This command creates the object module CODY. OBJ and the listing 
file CODY.LST using the files CODY.FTN and LOWELL. FTN as input. 
CODY.LST is printed on the line printer. See the next example. 
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> FORTRAN CODY , LOWELL/LIST 

This command creates the object module CODY. OBJ and the listing 
file LOWELL. LST using the files CODY.FTN and LOWELL. FTN as input. 
LOWELL. LST is not printed on the line printer. 

> FORTRAN DHARHA , HEX ICO/MAP 

This command creates the object module DHARMA.OBJ and the listing 
file MEXICO. LST using the file DHARMA.FTN and MEXICO. FTN as 
input. The listing file includes a storage map and diagnostics. 
The listing file is not printed on the line printer. 



Notes 



It is not uncommon for installations to have more than one 
FORTRAN compiler available. Since the default file type is the 
same for all DIGITAL FORTRAN compilers, you will have to use some 
care in differentiating source files for the different compilers. 

See the FORTRAN documentation supplied with your system. 



6.2.4 COBOL 

COBOL is a language widely used for business applications. 
RSX-11M/M-PLUS systems support both COBOL-81 and PDP-11 COBOL. Since 
these products are optional software, your system may include one, 
both, or neither of these compilers. 

Both the COBOL-81 and PDP-11 COBOL compilers convert source files 
written in the COBOL language to relocatable object modules. The Task 
Builder uses these modules to produce task-image files that can be run 
on your system (see Section 6.4). 

The next two sections discuss how to invoke each COBOL compiler. For 
COBOL-81, use the COBOL command (see Section 6.2.4.1)/ For PDP-11 
COBOL, use the COBOL/C11 command (see Section 6.2.4.3). Section 
6.2.4.2 gives examples for the COBOL-81 compiler. Section 6.2.4.4 
gives examples for the COBOL/C11 compiler. 



6.2.4.1 COBOL-81 

This section discusses the command line format and compile-time 
qualifiers for COBOL-81. Normal defaults for qualifiers are 
indicated. However, these defaults will not apply to your system if 
your system manager changed the default settings when installing the 
compiler. 

If you are using a compiler that has not been supplied by DIGITAL, 
specify the COBOL command with the /USING qualifier. The format is: 

COBOL/US ING: usercompi ler 
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Format 

COBOL [ /qua 1 if ier [s] ] filespec 

Command Qualifiers 

/[NO]ANSI_FORMAT 
/[NO]CHECK:arg 

[NO] BOUNDS 

[NO] PERFORM 

ALL 

NONE 
/CODE: [NO]CIS 
/ [NO] CROSS_REFERENCE 
/[NO] DEBUG 

/[NO] DIAGNOSTICS [:f ilespec] 
/ [NO] LIST [ : filespec] 
/NAMES: xx 

/[NO]OBJECT[:f ilespec] 
/[NO]OVERLAY_DESCRIPTION 
/[NO] SHOW: [NO] MAP 
/[NO] SKELETON 
/[NO] SUBPROGRAM 
/TEMPORARY: device 
/[NO] TRUNCATE 
/USING: user compiler 
/[NO]WARNINGS: [NO] INFORMATIONAL 

Parameter 

filespec 

Specifies the source file to be input to the COBOL-81 compiler. 

File input to the COBOL-81 compiler must contain COBOL source 
code. File specifications must have file names. The default 
file type is .CBL. 

Command Qualifiers 

/[NO] ANSI_FORMAT 

The /ANSI_FORMAT qualifier specifies that the source file is in 
conventional (or ANSI) format. Conventional format has 
80-character lines with Area A beginning in character position 8. 

The /NOANSI_FORMAT qualifier specifies that the source file is in 
terminal format, a DIGITAL-specif ied format that permits variable 
length lines with Area A beginning in character position 1. 

The default is /NOANSI FORMAT. 
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/[NO]CHECK:arg 

[NO] BOUNDS 

[NO] PERFORM 

ALL 

NONE 

The /CHECK and /CHECK: ALL qualifiers are equivalent — both to 
each other, and also to /CHECKrBOUNDS and /CHECK: PERFORM in 
combination. They add object code that checks the ranges of 
subscripts, indexes, and nested perform statements at run time. 

The /CHECK: BOUNDS qualifier compares subscript and index ranges 
at run time against the ranges defined by corresponding OCCURS 
clauses. If any range is exceeded during program execution, 
COBOL-81 issues an error message. 

The /CHECK: PERFORM qualifier determines whether or not your 
program's PERFORM statements are nested properly (if nested at 
all) . If COBOL-81 detects improper nesting during program 
execution, it issues an error message. 

The /NOCHECK and /CHECK:NONE qualifiers are equivalent — both to 
each other, and also to /CHECK: NOBOUNDS and /CHECK: NOPERFORM in 
combination. They suppress all range checking. 

The /CHECK: NOBOUNDS qualifier suppresses range checking only for 
subscripts and indexes. 

The /CHECK: NOPERFORM qualifier suppresses range checking only for 
nested PERFORM statements. 

The qualifiers that suppress range checking reduce task size and 
improve program performance. 

The default is /CHECK (/CHECK: ALL) . 

/CODE: [NO] CIS 

The /CODE:CIS qualifier tells the compiler to use CIS (Commercial 
Instruction Set) in the object code it produces. 

The /CODE:NOCIS qualifier tells the compiler not to use CIS. 

These qualifiers override the default for your system. They are 
used to develop programs that will execute on a different system 
than the one used for program development. For example, if your 
system has CIS, you use /CODE:NOCIS to compile a program that 
will run on a system without CIS. 

If your system has the Commercial Instruction Set installed, the 
default is /CODE:CIS. Otherwise, the default is /CODE:NOCIS. 
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/[NO]CROSS_REFERENCE 

The /CROSS_REFERENCE qualifier causes the compiler to produce a 
list file and to add two cross-reference tables to the end of the 
list file: one for data-names and one for procedure-names. In 
each table, the names you use in your COBOL program are listed 
alphabetically. Opposite each name is a list of every line 
number in which that name occurs. A "D" after a number indicates 
the line in which you define the name. An asterisk (*) after a 
line number indicates a destructive reference, such as a value 
assignment to a data-name. 

The /NOCROSS_REFERENCE qualifier suppresses production of the 
cross-reference tables. 

The default is /NOCROSS_REFERENCE. 

/[NO] DEBUG 

The /DEBUG qualifier indicates that you plan to include the 
C0B0L-81 Symbolic Debugger in your task image. To support the 
Symbolic Debugger, the compiler generates symbol information in 
the object module for all data-names and procedure-names in your 
program. 

If you include the Symbolic Debugger in your program, you must 
also use the /DEBUG qualifier to the LINK/C81 command (see 
Section 6.4.3). 

The /NODEBUG qualifier suppresses generation of symbol 
information in the object module. 

The default is /NODEBUG. 

/ [NO] DIAGNOSTICS [ : f ilespec] 

The /DIAGNOSTICS qualifier creates a diagnostics file that 
contains the compiler diagnostic summary. If you do not append a 
file specification, the diagnostics file has the same file name 
as your source file, and the file type .DIA. 

The /NODIAGNOSTICS qualifier suppresses the creation of a 
diagnostics file. 

The default is /NODIAGNOSTICS. 

/ [NO] LIST [ : f ilespec] 

The /LIST qualifier produces a list file which contains both the 
complete source code and any diagnostic messages. If you do not 
append a file specification, the list file has the same file name 
as the source file and has the file type .LST. 

The /NOLIST qualifier suppresses the production of a list file. 

The default is /NOLIST. 
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/NAMES: XX 

The /NAMES:xx qualifier tells the compiler to use the two 
alphanumeric characters you specify as the PSECT kernel for your 
program. You use this qualifier to ensure unique identification 
for PSECT kernels when your task image uses both subprograms and 
segmentation. 

/ [NO] OBJECT [ : f i lespec] 

The /OBJECT qualifier produces an object module. If you do not 
append a file specification to the qualifier, the object module 
has the same file name as the source, and the file type .OBJ. 

The /NOOBJECT qualifier suppresses production of an object module 
and its associated skeleton ODL file. (See the description of 
/[NO] SKELETON.) 

The default is /OBJECT. 

/[NO]OVERLAY_DESCRIPTION 

The /OVERLAY_DESCRIPTION qualifier produces two files — an 
indirect command file and an Overlay Descriptor Language file. 

The indirect command file has the same file name as the source 
and the file type .CMD. It can be input to the Task Builder to 
create the task image. 

The Overlay Descriptor Language file has the same file name as 
the source and the file type .ODL. It contains pointers to 
certain support routines that must be included in your task image 
(for example, system support for file input/output) . 

If you plan to use the LINK/C81 command to task-build your 
program, do not use the /OVERLAY_DESCRIPTION qualifier. LINK/C81 
also creates a .CMD and an .ODL file, and cannot reference the 
.CMD and .ODL files created during program compilation. 

The /NOOVERLAY_DESCRIPTION qualifier suppresses production of 
.CMD and .ODL files during program compilation. 

The default is /NOOVERLAY_DESCRIPTION. 
/[NO] SHOW: [NO] MAP 

The /SHOW and /SHOW:MAP qualifiers are equivalent. They cause 
the compiler to produce a list file and to append two offset maps 
to the list file. One offset map refers to the Data Division and 
one to the Procedure Division. The compiler provides these maps 
for use with ODT (the On-Line Debugging Tool) . Consult the 
IAS/RSX-11 ODT Reference Manual for more information. 

The /NOSHOW and /SHOW:NOMAP qualifiers are equivalent. They 
suppress production of the offset maps. 

The default is /NOSHOW (/SHOW: NOMAP) . 
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/[NO] SKELETON 

The /SKELETON qualifier produces a skeleton ODL file, which 
specifies the overlay structure for the object module. This file 
has the same file name as the source and the file type .SKL. 

You cannot use the /SKELETON qualifier to override the /NOOBJECT 
qualifier. That is, an .SKL file cannot be produced when the 
.OBJ file is suppressed. 

The /NOSKELETON qualifier suppresses production of the .SKL file. 

You cannot use the /NOSKELETON qualifier if you plan to 
task-build your program with the LINK/C81 command (see Section 
6.4.3). LINK/C81 assumes the presence of the .SKL file. 
Although the .SKL file is not strictly necessary for all 
programs, DIGITAL does not recommend that you suppress its 
production unless you are familiar with task-building 
alternatives to LINK/C81. 

The default is /SKELETON. 

/[NO] SUBPROGRAM 

The /SUBPROGRAM qualifier tells the compiler to treat the source 
file as a subprogram. You should use this qualifier only if the 
subprogram does not use parameters from the main program; that 
is, if it does not contain the Procedure Division USING header. 

The /NOSUBPROGRAM qualifier tells the compiler to treat the 
source as a main program. 

The default is /NOSUBPROGRAM. 

/TEMPORARY :dev ice 

The /TEMPORARY qualifier tells the compiler to store the 
temporary work files it uses during program compilation on the 
device you specify. Since the default device is the system disk 
(SY:), this qualifier is useful if there is little system disk 
space available. 

/[NO] TRUNCATE 

The /TRUNCATE qualifier tells the compiler to perform decimal 

truncation on the values of COMP data items. With decimal 

truncation, the maximum value the data item can contain depends 
on the item's PICTURE character-string. 

The /NOTRUNCATE qualifier tells the compiler to perform binary 
truncation on the values of COMP data items. With binary 
truncation, the maximum value a COMP item can contain depends on 
its storage allocation. 

The default is /NOTRUNCATE. 
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/[NO] WARNINGS: [NO] INFORMATIONAL 

The /WARNINGS and /WARNINGS: INFORMATIONAL qualifiers are 
equivalent. They cause the compiler to issue informational, 
warning, and fatal diagnostics. 

The /NOWARNINGS and /WARNINGS : NOINFORMATIONAL qualifiers are 
equivalent. They suppress production of informational, warning, 
and fatal diagnostics. 

The default is /WARNINGS (/WARNINGS: INFORMATIONAL) . 



6.2.4.2 COBOL-81 EXAMPLES 



>COBOL 

File(s)? DULUOZ 

This example compiles the COBOL-81 source file DULUOZ. CBL into the 
relocatable object module DULUOZ. OBJ. 

>cobol/list:ti: sax 

This example creates the object file SAX. OBJ from the COBOL-81 source 
file SAX. CBL and prints the compiler listing on your terminal. No 
listing file is printed on the line printer or retained in your 
current UFD. 

For more detailed information on compiling your COBOL-81 source 
program, refer to the COBOL-81 RSX-11M/M-PLUS User's Guide. 



6.2.4.3 PDP-11 COBOL 

This section discusses the command line format and compile-time 
qualifiers for PDP-11 COBOL plus gives you the MCR equivalents to the 
DCL qualifiers. The defaults for the qualifiers are included in the 
qualifier descriptions. You can override these defaults only in the 
PDP-11 COBOL compiler command line. 

Format 

COBOL/C11 [/qualifier [s] ] filespec 

Command Qualifiers 

DCL Mode MCR Mode Equivalent 

/ANSI_FORMAT /CVF 

/NOANS I FORMAT 

/CHECK 

/NOCHECK /-BOU 

/CM6 /CM6 

/NOCM6 
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/CROSSREFERENCE /CREF 

/NOCROSSREFERENCE (default listing) 

/LARGESYMBOLTABLE:n /SYM:n 

/LIST[:f ilespec] (default listing) 
/NOLIST 

/NAMES:xx /KER:xx 

/NEST:n /PFM:n 

/OBJECT [ : f i lespec] 

/NOOBJECT ,=T 

/OVERLAY /OV 
/NOOVERLAY 

/POOLLITERALS 

/NOPOOLLITERALS /-PLT 

/READONLY /RO 
/NOREADONLY 

/SHOW:COPYLIST (default listing) 

/NOSHOW:COPYLIST /NL 

/SHOW: MAP /MAP 

/NOSHOW:MAP (default listing) 

/SHOW:VERBLOCATION /OBJ 

/NOSHOW:VERBLOCATION (default listing) 

/SKELETON 

/NOSKELETON /-SKL 

/SUBPROGRAM /SUB 
/NOSUB PROGRAM 

/TEMP:dev /TMP:dv 

/WARNINGS /ERR:1 

/NOWARNINGS /ERR: 2 

Parameter 

filespec 

Specifies a source file to be input to the PDP-11 COBOL compiler. 

File input to the PDP-11 COBOL compiler must contain COBOL source 
code. File specifications must have file names. The default 
file type is .CBL. 

Command Qualifiers 

/[NO]ANSI_FORMAT 

The /ftNSI_FORMAT qualifier specifies that the source file is in 

conventional format: 80-character lines with Area A beginning in 

character position 8. The default is /NOANSI_FORMAT. 
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The /CHECK qualifier specifies that the code generated will check 
that subscripts and indexes are in their legal bounds when they 
are used. 

The /NOCHECK qualifier suppresses this checking, which increases 
execution speed for programs with a large number of subscripted 
or indexed references. The default is /CHECK. 

/[NO] CM 6 

The /CM6 qualifier specifies that you wish the compiler to change 
all COMPUTATIONAL references to C0MPUTATI0NAL-6. The default is 
/N0CM6. 

/ [NO] CROSS_REFERENCE 

The /CROSS_REFERENCE qualifier specifies that you wish a 
cross-reference listing to be included as part of the listing 
file. 

/CROSS_REFERENCE implies /LIST. You do not need to include the 
/LIST qualifier unless you wish to use it to establish a name for 
the listing file different from the source file. 

The /CROSS_REFERENCE qualifier leaves the listing file in your 
current directory. 

/LARGE_SYMBOL_TABLE[:n] 

The /LARGE_SYMBOL_TABLE qualifier specifies that you wish the 
compiler to obtain more symbol-table space, where n is a number 
from 1 through 4. The default is 1. Here are the results of 
using this qualifier: 

Maximum Maximum 

n Data Names Procedure Names 

(approximate) (approximate) 

1 761 761 

2 1021 1021 

3 1531 1531 

4 2039 2039 

/[NO]LIST[:f ilespec] 

Specifies whether a compiler listing should be generated. The 
default is /NOLIST, meaning no compiler listing is generated. 

If you do not supply a file specification for this qualifier, the 
listing has a file name derived from the name of the source file, 
with the file type .LST. If you wish the listing to have a 
different name, supply the name as an argument to the /LIST 
qualifier . 

If your command line includes the /CROSS_REFERENCE qualifier, 
/LIST is implied and need not be specified. 

If your command line includes listing-control arguments to either 
/SHOW or /NOSHOW, /LIST is implied and need not be specified. 
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The only time you need to use /LIST with /CROSS REFERENCE or 
/[NO] SHOW is when you wish to give the listing fTle a filespec 
other than the default. The listing file appears in your 
directory. 



/NAMES: xx 



The /NAMES qualifier specifies that you wish the compiler to 
generate program section names that use the 2-character kernel, 
xx, to make them unique for this compilation. xx is a 
2-character text string that may include the numerals through 9 
and the letters A through Z. 

/NESTrn 

The /NEST qualifier allows you to specify the maximum number of 
nested PERFORM statements in the program. The compiler generates 
a nested PERFORM stack equal in depth to the decimal number n. 
The default is 10. 

/[NO] OBJECT [:filespec] 

The /NOOBJECT qualifier specifies that you do not wish to create 
an object file. Use this qualifier if you wish only to check for 
errors or generate a listing. 

/OBJECT is the default and specifies that you wish to create an 
object file. The optional filespec argument enables you to give 
the object file a name different from that of the source file. 

/[NO] OVERLAY 

The /OVERLAY qualifier specifies that you wish the compiler to 
make all procedural program sections overlayable. This is done 
by keeping procedural statements out of the root section. 

/NOOVERLAY is the default. 

/ [NO] POOL_LITERALS 

The /POOL_LITERALS qualifier specifies that you wish the compiler 
to pool literals automatically to minimize the memory required to 
store them. This is the default. Since pooling literals slows 
down the speed of the compilation, you can specify 
/NOPOOL_LITERALS to speed it up. 

/[N0]READ_0NLY 

The /READ_ONLY qualifier specifies that you wish the compiler to 
generate a read-only program section for the procedure division 
object module. The default is /NOREAD_ONLY, which means these 
object modules are read/write. 

/[NO] SHOW: (arg[,s] ) 
COPY_LIST 
MAP 
VERB_LOCATION 

The /SHOW and /NOSHOW qualifiers specify elements you wish 
included in or excluded from the listing file. If you specify 
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only a single argument, the parentheses are not needed. Your 
command line can include both /SHOW and /NOSHOW. 

/SHOW implies /LIST, but if you wish the listing file to have a 
name other than the default, you must still use /LIST. 

The qualifier /NOSHOW:COPY_LIST specifies that you do not wish 
the listing file to include source statements copied from a 
library file. The resulting listing includes only the COPY 
statement. The default is /SHOW:COPY_LIST. 

The /SHOW:MAP qualifier specifies that you wish the listing to 
include any external subprograms that were referenced plus the 
following special maps: 

• Data Division 

• Procedure Division 

• Data and Control Program Sections 

• OTS Routine References 

• Segmentation 

The default is /NOSHOW:MAP. 

The /SHOW:VERB_LOCATION qualifier specifies that you wish the 

listing file to include the object location of the code for each 

program verb. The information is listed on the line preceding 

the source statement it describes. The default is 
/NOSHOW: VERB_LOCATION . 

/[NO] SKELETON 

The /SKELETON qualifier specifies that you wish the compiler to 
create a skeleton Overlay Description Language (.SKL) file. This 
is the default operation. The file is named after the file named 
in the COBOL/C11 command, with the file type .SKL. If you do not 
wish the .SKL file created, specify /NOSKELETON. 

/[NO] SUBPROGRAM 

The /SUBPROGRAM qualifier tells the compiler to treat the source 
file as a subprogram. You should use this qualifier only if the 
subprogram does not use parameters from the main program; that 
is, if it does not contain the Procedure Division USING header. 

The /NOSUBPROGRAM is the default and means the compiler will 
treat the source as a main program. 

/TEMP:dev 

The /TEMP qualifier tells the compiler to store the temporary 
work files it uses during program compilation on the device you 
specify. Since the default is the system disk (SY) , this 
qualifier is useful if there is little system disk space 
available. Do not specify a colon (:) as a delimiter after dev. 
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/WARNINGS 



The /WARNINGS qualifier specifies that you wish both warning and 
fatal diagnostics printed in the listing. See /NOWARNINGS. 

The default, without either /WARNING or /NOWARNING specified, is 
to print informational, warning, and fatal diagnostics. 



/NOWARNINGS 



The /NOWARNINGS qualifier specifies that you wish only fatal 
diagnostics printed in the listing. See /WARNINGS. 



Notes 



See the PDP-11 COBOL documentation supplied with your system for 

further information. 



6.2.4.4 COBOL/C11 Examples 

>C0B0L/C11 LEDUX 

This example compiles the COBOL/C11 source file LEDUX. CBL into the 
relocatable object module LEDUX. OBJ. 

>CQBOL/Cli/LIST MARDOU 

This example creates an object module, MARDOU. OBJ, and a COBOL-11 
compiler listing, MARDOU. LST, both of which appear in your current 
UFD. 



>COBOL/C1 1/1.1 ST! MARDOU LEDUX 

This example creates the object module LEDUX. OBJ and a compiler 
listing, MARDOU. LST, from the COBOL-11 source file LEDUX. CBL. Both of 
the output files appear in your current UFD. 

>COBOL/C 11 /LIST: GALLOWAY/SHOW J HAP 

This example creates an object module called GALLOWAY. OBJ and a 
listing file called GALLOWAY. LST. The listing file includes the 
special map with the data divisions, procedure map, segmentation map, 
program sections, and so forth, as described under the /SHOW 
qualifier . 



6.2.5 CORAL 66 

RSX-11M/M-PLUS systems support CORAL 66, a high-level block-structured 
programming language. CORAL stands for Computer On-Line Real-Time 
Applications Language. 
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CORAL 66 is the standard general-purpose language prescribed by the 
British Government for real-time and process-control applications. It 
is defined in BS 5905, British Standard Specification for Computer 
Programming Language CORAL 66. 

CORAL 66 is designed to replace assembly-level programming in modern 
industrial and commercial applications. It is used for long-life 
products where ease of maintenance and flexibility are required. 
Because this compiler is optional software, your system may not 
include it. 

Format 

CORAL[/qualifier[s] ] filespec[ ,s] 

Command Qualifiers 

/[NO] CHECK 
/CODE:arg 
EIS 
FIS 
FPP 
PIC 

(EIS, PIC) 
(FIS, PIC) 
(FPP, PIC) 
/ [NO] EXTEND_SOURCE 
/[NO]LIST[:f ilespec] 
/[NO]MACHINE_CODE 
/NAMES :x 

/ [NO] OBJECT [ : f ilespec] 
/ [NO] OPTIMIZE!: LEVEL :n] 
/READ_ONLY[:arg] 
ALL 
NONE 

PURE_DATA 
/[NO]SHOW[:(arg[,s])] 
ALL 

EXPANSIONS 
NONE 

OVERRIDE 
SOTOCE 
STATISTICS 
SYMBOLS 
/[NO] STANDARD 
/TEST[:n] 
/[NO]TRACEBACK 
/WIDTH :n 

Parameter 

f ilespec[ ,s] 

Specifies the file or files to be compiled. If you name more 
than one file, separate the filespecs with commas. 

Files input to the CORAL 66 compiler must contain CORAL 66 source 
code. The default file type is .COR. 
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Command Qualifiers 

/[NO] CHECK 

The /CHECK qualifier specifies that the code generated will check 
that all subscripts used in array and switch references are 
within bounds. 

The default is /NOCHECK. 

/CODE:arg 
EIS 
FIS 
FPP 
PIC 

The /CODE qualifier allows you to choose (at compile time) the 
instruction set for which the code is to be generated regardless 
of which machine is used to compile the source program. 

EIS means that the code uses the Extended Instruction Set. The 
default is /CODE:EIS. 

FIS means that the code uses the Floating Instruction Set. 

FPP means that the code uses the Floating Point Processor. 

NOTE 

You cannot specify any combinations of EIS, FIS, and FPP 
codes. 

PIC means that the code is position-independent. With the 

qualifier set to /CODE:PIC, a SWITCH declaration in the CORAL 

source is compiled as a list of relative jumps in instruction 
space. 

If you specify /CODE:NOPIC (the normal default), a SWITCH 
declaration is compiled as a list of addresses in data space. 

If you want to GOTO a switch that has been declared in COMMON and 
any target switch label is in an overlaid segment of your task, 
you must use /CODE: PIC for the Autoload mechanism to work. 

As with other qualifiers, the supplied default, /CODE:NOPIC, may 
be changed when the CORAL 66 compiler is installed. 

You can combine EIS, FIS, and FPP codes with PIC as follows: 

/CODE: (EIS, PIC) 
/CODE: (FIS, PIC) 
/CODE: (FPP, PIC) 

/[NO]EXTEND_SOURCE 

The /NOEXTEND_SOURCE qualifier causes the compiler to process 
onl" the first 72 characters of source inout per line. This is 
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used if your input is on punched cards and the cards contain 
sequencing information in columns 73 through 80. 

The default is /EXTEND_SOURCE, meaning that all characters in an 
input line are processed. 

NOTE 
The compiler treats a TAB as a single character. 

/[NO]LIST[:filespec] 

The /LIST qualifier allows you to specify whether a compiler 
listing should be generated. The default is /NOLIST, meaning no 
compiler listing is generated. 

If you do not supply a file specification for this qualifier, the 
listing has a file name derived from the name of the first source 

file in the CORAL command and the file type .LST. If you want 

the listing to have a different name, supply the name as an 

argument to the /LIST qualifier. If you do supply a name, the 

listing file appears in your directory but is not printed on the 
line printer. 

The /LIST qualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /LIST is used as a command qualifier with no 
filespec, the listing file is placed in your directory and 
printed on the line printer. If /LIST is used as a filespec 
qualifier, the listing file appears in your directory but is not 
printed on the line printer. If /LIST is used as a filespec 
qualifier, the listing file takes the name of that file. 

/[NO]MACHINE_CODE 

The /MACHINE_CODE qualifier specifies that you wish the compiler 
listing to include a representation of the machine code 
generated. The default is /NOMACHINE_CODE. 

/MACHINE_CODE produces a listing of the object code produced by 
the compiler, correlated with the source file and line number. 
The first octal number is the offset of the instruction in the 
current program section (segment) . This is followed by an octal 
representation of the internal code format and the instruction in 
a format similar to MACRO-11. 

/MACHINE_CODE implies /LIST. You do not need to use the /LIST 
qualifier unless you wish to specify a name for the listing file 
that is different from any of the names included in the 
compilation. 

The /MACHINE_CODE qualifier behaves in a different manner 
depending on whether it is given as a command qualifier or a 
filespec qualifier. If /MACHINE_CODE is used as a command 
qualifier, the listing file is placed in your directory and 
printed on the line printer. If /MACHINE_CODE is used as a 
filespec qualifier, the listing file takes the name of that file. 
The listing file appears in your directory but is not printed on 
the line printer. 
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/NAMES :x 

The /NAMES qualifier causes the first character of 
compiler-generated program-section names to be the character 'x' 
in order to make them unique for this compilation. If you do not 
specify /NAMES, compiler-generated program-section names start 
with the character 'S'. 

/ [NO] OBJECT [ : f ilespec] 

This qualifier allows you to specify whether or not the compiler 
must generate an object module. The default is /OBJECT- which 
creates an object module. The default name of the object file 
created by CORAL 66 is the name of the last-named source file and 
the file type .OBJ. If you wish the object file to have a 
different name, supply the name as an argument to the /OBJECT 
qualifier . 

/NOOBJECT specifies that no object module is created. You can 
use the /NOOBJECT qualifier to get a compiler listing file to 
check for errors without generating object code. 

/[NO] OPTIMIZE [: LEVEL :n] 

The /OPTIMIZE qualifier allows you to optimize the function of 
CORAL 66 source programs. The qualifier allows code generated by 
the compiler to be replaced, where possible, by more efficient 
code constructions. 

/NOOPTIMIZE or /OPTIMIZE:LEVEL:0 means no optimization occurs. 

/OPTIMIZE or /0PTIMIZE:LEVEL:1 allows three optimization 
iterations. The default is /OPTIMIZE. 

/OPTIMIZE:LEVEL: 2 allows as many iterations as necessary. 

/READ_ONLY [:arg] 
ALL 
NONE 

PURE_DATA 

The /READ_ONLY qualifier allows you to alter the READ-ONLY or 
READ-WRITE attributes of program sections. 

/READ_ONLY: ALL creates pure data and instruction program sections 
with the READ-ONLY attribute and impure data program sections 
with the READ-WRITE attribute. 

/READ_ONLY:NONE creates all program sections with the READ-WRITE 
attribute. 

/READ_ONLY: PURE DATA creates pure data program sections with the 
READ-ONLY attribute and all other program sections with the 
READ-WRITE attribute. The default is /READ ONLY: PURE DATA. 



6-36 



PROGRAM DEVELOPMENT 



CORAL 66 (Cont.) 



/[NO]SHOW[: (arg[,s] ) ] 
ALL 

EXPANSIONS 
NONE 

OVERRIDE 
SOURCE 
STATISTICS 
SYMBOLS 

The /SHOW and /NOSHOW qualifiers specify elements you wish 
included in or excluded from the listing file. If you specify 
only a single argument, the parentheses are not needed. Your 
command line can include both /SHOW and /NOSHOW. 

/SHOW implies /LIST, but if you wish the listing file to have a 
name other than the default, you must still use /LIST. 

/SHOW as a command qualifier causes the file to be printed on the 
line printer. /SHOW as a filespec qualifier prevents the listing 
file from being printed. The default is /SHOW. 

/SHOW: ALL is equivalent to: 

/SHOW: ( EXPANSIONS , OVERRIDE , SOURCE , STATISTICS , SYMBOLS) 

The /SHOW: EXPANSIONS qualifier causes the compiler to produce a 
source listing with all macros expanded. Line numbers are not 
incremented during macro expansions, so if an error occurs, the 
line number printed will refer to the source line in which the 
macro was used. The default is /SHOW: NOEXPANSIONS. 

The /SHOW: NONE qualifier performs the same function as /NOSHOW. 

The /SHOW: OVERRIDE qualifier overrides /NOLIST in the source 
code. The default is /SHOW: NOOVERRIDE. 

The /SHOW: SOURCE qualifier causes the compiler to produce a 
source listing. The default width of the listed file is 132 
characters but may be changed to another width by using the 
/WIDTH qualifier. Each listed line of the source file is 
prefixed by the current file number and line number. When 
several files are compiled, the line numbers restart with each 
new file. The listing may be made more readable by, for example, 
including form feeds in the source at the start of each segment 
or large procedure. 

Each page is printed with a two-line header. The first line 
gives the following information: 

program name 

compiler name and version 

time and date at the start of compilation 

page number 

If a 'TITLE' statement has been processed, the text in that 
statement is printed on the second line. The 'TITLE' text may be 
up to 64 characters in length. 

The /SHOW:NOSOURCE qualifier means a source listing is not 
produced. The default is /SHOW:SOURCE. 
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The /SHOWrSTATISTICS qualifier causes the compiler to produce 
statistics displaying information on the internal working of the 
compiler. The /SHOW:NOSTATISTICS qualifier suppresses this 
function. 

The default is /SHOW: STATISTICS. 

The /SHOW:SYMBOLS qualifier causes the compiler to print out data 
and label maps, sorted by symbol names in alphabetical order. 
Where symbols declared in different contexts have identical 
names, these are further sorted into ascending file and line 
number order . 

The /SHOW.NOSYMBOLS qualifier means the compiler does not create 
a listing of the symbol table. The default is /SHOW: SYMBOLS. 

/[NO] STANDARD 

The /STANDARD qualifier highlights non-IECCA keywords in the 
listing as warning messages. (IECCA is an acronym for the Inter 
Establishment Committee for Computer Applications, the body 
responsible for approving computer hardware and software for 
British military applications.) For example, the keyword 
'INCLUDE' will generate a message of the following format: 

Error 213 in File 2 Line 10 Character 1 

Warning-Non-Standard Keyword 

The /NOSTANDARD qualifier suppresses this function. The default 
is /NOSTANDARD. 

/TEST[:n] 

The /TEST qualifier allows you to retain or omit declarations and 
statements from a particular compilation without editing the 
source text. This qualifier is used in conjunction with the 
'TEST' keyword. You may specify any declarations or statements 
in the source program as follows: 

'TEST' (X) 'INTEGER' VAR ; 

where x is any positive integer. 

If you specify the /TEST[:n] qualifier, the compiler will process 
all 'TEST' (x) statements where x is less than or equal to n. 
Therefore, to ignore all 'TEST' statements, set /TEST:0 or omit 
the qualifier at compile time. The default is /TEST:0. 

/[NO]TRACEBACK 

The /TRACEBACK qualifier generates additional code to print 
source-file and line-number information in run-time error 
messages. 

/NOTRACEBACK suppresses this function and is the default. 
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/WIDTH :n 



The /WIDTH:n qualifier allows you to set the listing file to 
specific width in the decimal range 8 through 132. 

The default width is /WIDTH: 132. 



6.3 LIBRARY 

LIBRARY creates and maintains user-written library files, or 
libraries. Libraries can contain macro definitions, object modules, 
or, in the case of universal libraries, anything. 

Maintenance functions of LIBRARY include extracting, deleting, 
inserting, and replacing library entries. Libraries can be compressed 
(squeezed) to save disk space. Library contents can also be listed. 

User-written object module libraries can be used as input to the Task 
Builder, either directly or through LINK. The Task Builder (TKB) 
searches for definitions of all global symbols referenced in your 
program in the following fashion. First, TKB searches other modules 
included in the LINK command, then it searches a user-written object 
module library included in the LINK command, and finally it searches 
the system library. 

User-written macro libraries hold source macros for use as input by 
the MACRO-11 Assembler, either directly or through MACRO. The 
assembler searches the library you specify for macros listed in .MCALL 
statements and called in your source program before searching the 
system macro library. 

In general, LIBRARY handles object module libraries and macro 
libraries in the same way. This means that references in this section 
to modules can be usually taken as referring to macros as well as 
object modules. 

Libraries are direct access files containing one or more modules of 
the same type. These files are organized for rapid access by the Task 
Builder and MACRO-11 Assembler. Universal libraries can contain 
virtually anything to which you wish to have rapid access, such as 
text files. 

Library files contain two directory tables. The entry point table 
(EPT) contains entry point names (global symbols) . The module name 
table (MNT) contains module names. Both tables are in alphabetical 
order. Object module names are derived from .TITLE directives, while 
entry point names are derived from defined global symbols. Once an 
entry point is located, its associated module can be accessed 
directly. Macro module names are derived from .MACRO directives; 
macros are linear code and do not have entry points. 

This section does not teach you how to use the Librarian utility, but 
only how to use the LIBRARY command. See the Notes for suggested 
further reading. 
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Format 



LIBRARY 

Operation? operation [/qualifier [s] ] 

LIBRARY operation[/qualif ier [s] ] 

LIBRARY @filespec 

LIBRARY performs the following operations: 

COMPRESS CREATE DELETE EXTRACT INSERT 
LIST REMOVE REPLACE 

Each of these operations is treated as a separate command in this 
description. 



Notes 



LIBRARY invokes the Librarian Utility Program (LBR) . To use this 
command successfully, you must familiarize yourself with this 
utility, which is described in Chapter 10 of the RSX-11M/M-PLUS 
Utilities Manual . 

LBR format differs from the format of the DCL LIBRARY command. 
DCL translates the DCL command line into LBR format. The 
descriptions presented here include cross-references to the 
equivalents in LBR format of the DCL command elements. Use the 
SET DEBUG command to see the translation. 

If you wish to use indirect command files with LIBRARY, the 
indirect command file must be in LBR format, not DCL format. 
Only one level of indirect referencing is permitted. 

You should also be familiar with the way the MACRO-11 Assembler 
and the Task Builder use libraries. See the IAS/RSX-11 MACRO-11 
Reference Manual , the RSX-11M/M-PLUS Task Builder Manual , and the 
RSX-11M/M-PLUS Guide to Program Development for more information. 

You cannot use wildcards (*, %) in file specifications in LIBRARY 
operations . 

Library modules are limited to 65536 words per module. 

Libraries are limited to 65536 blocks. 

The LIBRARY command operates on three kinds of libraries: 

• Object module libraries. These can be user libraries or 
one of the following DIGITAL-supplied libraries: 

LBO: [l,l]SYSLIB.OLB System library (this is the 

library searched by the Task 
Builder by default) . 

LBO: [1, 1] VMLIB.OLB Virtual Memory Management 

library 

LBO: ri.n EXELIB.OLB Executive library 
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LBO: [i,l]RMSLIB.OLB 

LBO: [l,l]FOROTS.OLB 
LBO: [l,l]F4POTS.OLB 



Record Management 
library 



Services 



FORTRAN IV library (optional) 

FORTRAN-IV-PLUS library 
(optional) 



Macro libraries. These can be user libraries or one of 
the following DIGITAL-supplied libraries: 



LBO : [ 1 , 1 ] RSXMAC . SML 

LBO: [1,1]EXEMAC.MLB 
LBO: [1,1]RMSMAC.MLB 



System macro library. This 
is the library searched by 
the assembler by default. 
(Note nonstandard file type) 

Executive macro library 

Record Management Services 
library 



The Librarian utility can also be used to create and maintain a 
third form, universal libraries, using the /UNIVERSAL qualifier 
on some of the LIBRARY commands. 

The LIBRARY command and utility have no relationship to the other 
kinds of libraries used on RSX-11M/M-PLUS systems. Specifically, 
LBR has no relationship to supervisor mode libraries or 
core-resident libraries created by the Task Builder. 

On RSX-aiM-PLUS, two UFDs, the system UFO (LBO: [1 #54], which 
contains privileged system tasks', such as commands) and the 
library UFD (LBO: 13,5-4], which contains honpri vileged system 
tasks, such as the utilities) 1 , are also called libraries, but: 
also have no relationship to the LIBRARY command. On RSX-1 1.M 
systems, all such tasks are placed in the system UFD. 

The /SQUEEZE qualifier causes all text to the right of the 
rightmost semicolon to be deleted. This convention permits you 
to preserve any meaningful semicolon by adding another semicolon 
to its right. Examples of meaningful semicolons include using 
the ASCII value of the semicolon in code, or a semicolon marking 
a comment you wish to preserve. The following line of code moves 
the ASCII value of the semicolon to register 1: 



MOVB 



Rl 



but emerges after the /SQUEEZE as 

MOVB # ' 
To preserve the meaningful semicolon, use the following form: 

MOVB #';, Rl ; THIS DUMMY COMMENT SAVES THE CODE 
which emerges after the /SQUEEZE as 

MOVB # ■ ; , Rl 
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Similarly, the following comment: 

;NEXT 5 LINES ARE CRUCIAL 
disappears after the /SQUEEZE, but this form 

;NEXT 5 LINES ARE CRUCIAL ; 
emerges after the /SQUEEZE as 

;NEXT 5 LINES ARE CRUCIAL 

Keep this convention in mind whenever you are using the /SQUEEZE 
qualifier . 

All error messages are described in Section 6.3.9. Some error 
messages are closely related to particular LIBRARY operations. 
Descriptions of these messages are repeated in the section on the 
operation to which they pertain. 

6.3.1 LIBRARY/COMPRESS 

LIBRARY/COMPRESS physically deletes modules that have been logically 
deleted through LIBRARY/DELETE. You can rename the resulting 
compressed library. 

Format 

LIBRARY/COMPRESS [: (arg[ ,s] ) ] libspec [newlibspec] 
GLOBAL :n 
MODULES :n 
BLOCKS :n 

Parameters 

libspec 

Specifies the name of the library file to be compressed. The 
default type is .OLB, specifying an object module library. If 
you wish to compress a macro library (standard file type .MLB) , 
or a universal library (standard file type .ULB) , you must 
specify the file type explicitly. 

newlibspec 

This optional parameter specifies a name for the newly compressed 
library. If you do not specify a name, the new file has the same 
name as the old one. The old file is not deleted after you 
create a new library with this command. 

Arguments 

If you are specifying more than one argument, the arguments must 
be enclosed in parentheses and separated by commas. If you are 
specifying only one argument, the parentheses are not necessary. 
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GLOBALS:n 



The GLOBALS argument specifies the number of global symbols 
(entry point table entries) to allocate. The default n is the 
number of global symbols allocated in the old library. The 
maximum n is 4096. The value of n is always forced to zero for 
macro and universal libraries. 



M0DULES:n 



The MODULES argument specifies the number of entries to allocate 
in the module name table. The default value is the number of 
entries in the old library. The maximum number of module names 
is 4096. 

BLOCKS :n 

The BLOCKS argument specifies the size of the library in 256-word 
blocks. The default size is the size of the old library. 

Example 

>LIBRARY/COMPRESS LB ! T. i , 1 ] SYSLIB , OLE 

This example compresses the system object module library. 

Notes 

This command is equivalent to the LBR /CO switch applied to a 
library file. 

If you like, you can use LIBRARY/LIST before and after 
compressing a library to see the effects of the compress 
operation. 



6.3.2 LIBRARY/CREATE 

LIBRARY/CREATE creates a library and optionally inserts one or more 
modules into it. 

The library is a contiguous file created on a volume mounted on a 
random-access device, that is, disk or DECtape. 

Format 

i-i-Loru-im/ tnnfni, t= i<"yi »sj ) } i/yudiiiieti sj j nDspec linn lespecL ,sj j 
GLOBALS :n 
MODULES :n 
B LOCKS :n 

Command Qualifiers 

/[NO]GLOBALS 

/MACRO 

/OBJECT 

/SELECTIVE_SEARCH 

/SQUEEZE 

/UNIVERSAL 
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Parameters 

litaspec 



Specifies the name of the library file being created. The 
default file type is .OLB if an object module library is being 
created, .MLB if a macro library is being created, and .ULB if a 
universal library is being created. 



inf ilespec [s] 



Specifies the file or files to be used as input to the new 
library file. If no input files are specified, an empty library 
file is created. The default file types are .OBJ when creating 
object module libraries, .MAC when creating macro libraries, and 
.UNI when creating universal libraries. 



Arguments 



If you are specifying more than one argument, the arguments must 
be enclosed in parentheses and separated by commas. If you are 
specifying only a single argument, the parentheses are not 
necessary. 



GLOBALS:n 



The GLOBALS argument specifies the number of global symbols 
(entry point table entries) to allocate. The default is 512 for 

V^JCH.1- J. i »J i. tl J. -L<=0 . »ilU V^Xv^ J..J "J-""J- *-V^^^^ H.^ v, i.~*. „,^^^^ -i.^ 

universal libraries, n can be from through 4096. 



MODULES :n 



The MODULES argument specifies the number of entries to allocate 
in the module name table. The default value is 256. n can be 
from through 4096. 

BLOCKS :n 

The BLOCKS argument specifies the size of the library in 256-word 
blocks. The default size is 100 blocks. 

Command Qualifiers 

/[NO] GLOBALS 

/NOGLOBALS specifies that global symbols are not to be included 
in the entry point table. 

Use this qualifier if you wish to use the same global symbols in 
more than one module. /GLOBALS is the default but is a no-op. 

/SELECTIVE_SEARCH 

Sets the selective search attribute bit in the module header of 
object modules as they are inserted into an object library. You 
must specify an input file or files. 

This c[ualii-ier uas meaning ior ooject TuOuUic ii^raries orixy . 
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Object modules with the selective search attribute are given 
special treatment by the Task Builder. Global symbols defined in 
modules with the selective search attribute are only included in 
the Task Builder's symbol table if they were previously 
referenced by other modules. 



/SQUEEZE 



The /SQUEEZE qualifier reduces the size of macro definitions by 

eliminating all trailing blanks and tabs, blank lines, and 

comments from macro text. You must specify an input file or 
files . 

This qualifier has meaning for macro libraries only. 

Macros that have been squeezed not only take up less room in the 
macro library file, but also take up less memory. 

See the Notes to Section 6.3 for important information on the 
/SQUEEZE qualifier. 

This /SQUEEZE qualifier is the equivalent of the LBR /SZ switch 
applied to the output library file when using the /CR switch. 



/MACRO 



The /MACRO qualifier specifies that the library being created is 
a macro library. 



/OBJECT 



The /OBJECT qualifier specifies that the library being created is 
an object module library. This is the default and need not be 
specified . 



/UNIVERSAL 



The /UNIVERSAL qualifier specifies that the library being created 
is a universal library. 



Example 



> LIBRARY 

Operation? CREATES ( GLOBALS J 128 » MODULES J 64 ) 

Library? CARNEGIE 

Modules? DEWEY > CONGRESS , MODERN 

This example creates the library CARNEGIE. OLB with a size of 100 
blocks (the default), 128 entry points, and 64 module names, and 
inserts object modules from the input files DEWEY. OBJ, 
CONGRESS. OBJ, and MODERN. OBJ. 



Notes 



This command is the equivalent of applying the LBR /CR switch on 
the output file. 
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Tables should be allocated to maximum anticipated size. 
Expanding table allocations requires using LIBRARY/COMPRESS to 
copy the entire file. 

If the qualifiers /SELECTIVE_SEARCH and /SQUEEZE are used with 
LIBRARY/CREATE, you must specify an input file or files. 



6.3.3 LIBRARY/DELETE 

LIBRARY/DELETE deletes modules from any library. See LIBRARY/REMOVE 
for removing global symbols (entry points) from a library. 

Format 

LIBRARY/DELETE libspec module[,s] 

Parameter 

libspec 

Specifies the name of the library from which modules are to be 
deleted. 

module[ ,s] 

You can specify as many as 15 names of modules to be deleted, 
separated by commas. 

If you do not specify the module list, you will be prompted for 
it. 



Example 



>LIHRARY/DELETE 

Library? BUMPERS 

Module(s)? BUGGYr BABY, RUBBER 

Hodules deleted! 

BUGGY 

BABY 

RUBBER 

This example deletes the modules BUGGY, BABY, and RUBBER from the 
latest version of the object module library BUMPERS. OLB. 



Notes 



This command is the equivalent of the LBR /DE switch applied to 
the output file. 

When you delete an entry from a library, the entry is not 
physically removed, but is marked for deletion. This means that 
although the module is no longer accessible, the file space it 
occupied is not available. To clear this space, use the 
LIBRARY/COMPRESS operation, Section 6.3.1. 
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If a specified module is not contained in the library, the 
following message is printed on your terminal: 

LBR — *FATAL* — No module named "name" 

All the modules in your list up to the incorrect module name will 
have been deleted. None of the modules following the incorrect 
module name will have been deleted. You should use LIBRARY/LIST, 
Section 6.3.6, to check which modules have been deleted and which 
have not. 

See LIBRARY/REMOVE (Section 6.3.7) for information on removing 
global symbols from libraries. 



6.3.4 LIBRARY/EXTRACT 

LIBRARY/EXTRACT reads one or more modules from a library and writes 
them into a specified output file. 

You can extract up to eight modules with a single LIBRARY/EXTRACT 
operation. If more than one module is extracted, the modules are 
concatenated in the output file. 

Format 

LIBRARY/EXTRACT/qualifier [:f ilespec] libspec module[,s] 

Command Qualifier 

/OUTPUT! :f ilespec] 
Parameters 
libspec 

Specifies the library from which modules are to be extracted. 

The default file type is .OLB, corresponding to an object module 
library. If you wish to extract from a macro or universal 
library, you must specify the appropriate file type. 

module[ ,s] 

Specifies the modules that are to be extracted. If you do not 

include a list, all modules in the library are extracted and 

concatenated in the output file in alphabetical order. You can 
specify up to eight modules, separated by commas. 

Command Qualifier 

The /OUTPUT qualifier specifies the file to which the extracted 
modules or macros are to be written. If you specify /OUTPUT 
without a filespec, the default is to write the modules to your 
terminal. This makes sense only for macro libraries or universal 
libraries containing text modules. 

If you do not include the qualifier, you will be prompted To?, to 
which you are to reply with a filespec. You can reply TI : to 
have the output printed on your terminal. 
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Examples 

>LIBR/EXTRACT/nilTPUTJHATH LBOJCl ilIISYSUiB Aft IT H 

This example extracts the module named ARITH from the library 
SYSLIB.OLB, the system object library. The module is placed in 
the default directory as a file named MATH. OBJ. 

>libr/extract/qut:ti : lbo: :i , i:rsxmac.sml siop$s 
.macro stof'*s err 
.mcall eur* 

MOV (PC)+j-<SP) 

.BYTE 131, ,1 

DIR* rERR 

.ENDH STOP*fi 

This example extracts the macro named STOP$S from the system 
macro library and prints it on the terminal. 



Notes 



This command is the equivalent of the LBR /EX switch applied to 
the library file as an input file. 

LIBRARY/EXTRACT has no effect on the library from which the 
modules are extracted. 



6.3.5 LIBRARY/INSERT 

LIBRARY/INSERT inserts modules from one or more files into a library. 

Format 

LIBRARY/INSERT libspec filespec[,s] 

Command Qualifiers 

/[NO]GLOBALS 

/SELECTIVE_SEARCH 

/SQUEEZE 

Parameters 

libspec 

Specifies the library into which modules are to be inserted. 

The default file type is .OLB. If you wish to insert modules 
into a macro library (file type .MLB) or a universal library 
(file type .ULB) , you must specify the file type explicitly. 

f ilespec [s] 

Specifies the file or files containing concatenated modules to be 
inserted into the specified library. 

Any number of files can be specified and each file can contain 
any number of concatenated modules. 
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The default file type is determined by the library into which 
modules are being inserted. It is .MAC for macro libraries and 
.OBJ for object module libraries, and .UNI for universal 
libraries . 

Command Qualifiers 

/[NO]GLOBALS 

/NOGLOBALS specifies that entry points for the specified modules 
are not to be included in the entry point table. 

Use this qualifier if you wish to insert global symbols having 
the same name as symbols already in the library file. The 
default, /GLOBALS, does not permit this operation. 

/SELECTIVE_SEARCH 

Sets the selective search attribute bit in the module header of 
object modules as they are inserted into an object library. You 
must specify an input file or files. 

Object modules with this attribute are given special treatment by 
the Task Builder. Global symbols defined in modules with the 
selective search attribute are not included in the Task Builder's 
symbol table unless they were previously referenced by other 
modules. 

/SQUEEZE 

Reduces the size of macro definitions by eliminating all trailing 
blanks and tabs, blank lines, and comments from macro text. You 
must specify an input file or files. 

Macros that have been squeezed not only take up less room in the 
macro library file but also take up less memory. 

See the Notes to Section 6.3 for important information on the 
/SQUEEZE qualifier. 

This qualifier is the equivalent of the LBR /SZ switch applied to 
the output file. 

Example 

>LIBR/INSERT 

Library? LBOJ CI , USYSLIB 

Module<s)? USERGUB 

This example inserts object modules from the file USERSUB.OBJ 
into the system object module lbrary, LBO: [1, 1] SYSLB.OLB. 

Notes 

This command is the equivalent of the LBR /IN command. 

Note that a single input file can contain more than one object 
module or macro. 

If you are inserting macros into a macro library, LIBRARY/INSERT 
insert only the .MACRO and .ENDM lines and what appears between 
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them. All text in the file not bracketed by these assembler 
directives is ignored. This feature is in addition to the action 
of the /SQUEEZE qualifier. 

If you attempt to insert a module that already exists in the 
library file, the following message is printed on your terminal: 

LBR — *FATAL*Duplicate module name "name" in filename 

If you attempt to insert a module with an entry point that 
duplicates one that is already in the EPT, the following message 
is printed on your terminal: 

LBR — *FATAL*Duplicate entry point "name" in filename 

In the case of either of these messages, all operations up to the 
point at which the error occurred should have been successful. 
No operations past that point will have taken place. Use 
LIBRARY/LIST to check which modules have been inserted and which 
have not. 



6.3.6 LIBRARY/LIST 

LIBRARY/LIST lists the names of all modules in a library on your 
terminal or in an output file. 



ffnrmaf 



LIBRARY/LIST [ :f ilespec] libspec 

Command Qualifiers 

/BRIEF 
/FULL 
/[NO] NAMES 

Parameter 

libspec 

Specifies the library you wish listed. The default file type is 
.OLB. If you wish to list a universal or macro library, you must 
specify the appropriate file type. 

Command Qualifiers 

/LIST[:filespec] 

If you do not include a filespec as an argument to /LIST, the 
library is listed on your terminal. 

If you include a filespec as an argument, the default device and 
UFD are the same as those of the library you are listing and NOT 
your current defaults. See the examples. 



/BRIEF 



The /BRIEF qualifier specifies that you wish the list to include 
only the module names. This is the default. See the examples. 
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/FULL 



The /FULL qualifier requests a listing of all module names, along 
with a module description, including size, date of insertion, and 
module-dependent information. See the examples. 

/[NO] NAMES 

The /NAMES qualifier requests a list of modules in the library, 
along with their entry points. The default is ,/NONAMES. See the 
examples . 

Examples 

>LIBRARY/LIST LBO t C 1 , nSYSLIB 

Directory of file SYSLIB, OLE i 1002 
ObJect module library crested by* LBR V06.00 
Last insert occurred 25--N0V-82 3t 19! 34 * 32 
MNT entries allocated: 7685 Available* 549 
EPT entries allocated; 2048? Available* 873 
File space available! 00309 words 
Recoverable deleted space* 14892 words 

ALERR 

ALSCT 

ALTPRI 

ANSPAD 

ARITH 



This example shows the default display from LIBRARY/LIST. Only 
the module names appear. The information appears on your 
terminal . 



>LIBRARY/ LI ST/FULL LBO * C 1 , 1 :.l SYSLIB 

Directory of file SYSLIB .OLE M 002 

Object module library treated by* LBR V06.00 
Last insert occurred 25-JUN-79 at 19*34*32 

MNT entries allocated* 763! Available* 549 
EPT entries allocated* 2048? Available* 873 
File space available* 00309 words 
Recoverable deleted space* 14892 words 

ALERR Size*00073 Inse rterf * 22--00T -82 IdentiOO 

ALSCT Size*00134 Inserted * 22-3CT--82 IdentJOO 

ALTPRI Size*00081 Inserted 5 22-0CT-82 Idenf.OO 

ANSPAD Size*00068 Inserted * 25-N0V--82 Iden t i 20 . OP.' 

ARITH Size!00088 Inserted * 22-0CT-82 I dent * 03 , 03 
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This example shows the display from LIBRARY/LIST/FULL, which 
includes full module descriptions. This information appears on 
your terminal. 

>LIBRARY/LIST/NAMES LBOICl rllSYSLIB 

Directory of file SYSLIB . OLB i 1002 
Object module library created by* LBR VG6.00 
Last insert occurred 25-N0V-82 at 19134132 
HNT entries allocated: 768? Available: 549 
EPT entries allocated: 2048S Available: 873 
File space available: 00309 words 
Recoverable deleted space: 14892 words 

** Hodule'.ALERR 
*ALERR 



** Module:ALSCT 
ALSCT 

** Module IALTPRI 
ALTPRI 

** ModuletANSPAD 
v.ANSP 

** Module:ARITH 
*DIV $MUL 



This example shows the display from LIBRARY/LIST/NAMES, which 
lists entry points for each module. 



>LIBRARY/LIST/FULL/NAMES LB0 J C 1 r nSYSLIB 

Directory of file SYSLIB . OLB 5 1002 
Object module library crested by: LBR M06.00 
Last insert occurred 25-N0V-32 et 19:34:32 
MNT entries allocated: 768? Available: 54'/ 
EPT entries allocated! 2048? Available! 873 
File space available! 0030? words 
Recoverable deleted space: 14692 words 



** HoduleJALERR Size!00073 Inserted ! 22-0CT-82 IderrUOO 
*ALERR 
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** ModulelALSCi Size!00134 Inserted J 22-0CT-82 IdentJOO 



ALSCT 



** Madule!ALTPRI Size!0008i Inserted! 22-0CT-82 IdenttOO 



ALTPRI 



** Module!ANSPAD Size!00068 Inserted! 25-0CT-82 Ident!20.0P6 



. .ANSP 



** ModulelARITH Si ze ! 00088 Inserted ! 22-0CT-82 Ident!03.03 



This example shows the display from LIBRARY/LIST/FULL/NAMES, 
which includes not only module descriptions but also entry points 
for each module. 



>SH0U DEFAULT 

DB2t [303,53 TT56! 

>LIBRARY/LIST!FRED.LIS LBO ! 1 1 » 1 3SYSL IB 

LBR — *FATAL*-0pen failure on file FRED, LIS 

In this example, the user intended to create a list of the 
modules in SYSLIB in the default UFD on the default device. The 
error message indicates that the listing file cannot be opened. 
This is because LBR attempted to place FRED. LIS on LBO: in 
[1,1], where the user did not have file creation privileges. See 
next example. 

>SH0W DEFAULT 

DB2! £303,51 TT56! 

>LI&RARY/Ll'ST!DB2:C303,5:iFREIULIS LBO t C 1 , 1 ]SYBLI B 

In this example, the user explicitly stated the device and UFD 
for the listing file and the command succeeded. 



Notes 



This command is the equivalent of applying the LBR /LI, /FU, or 
/LE switches to the listing file. 

Note that there are four possible listing formats with this 
command . 
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6.3.7 LI BR AR Y/REMOVE 

LIBRARY/REMOVE removes global symbols (entry points) from a library. 
See LIBRARY/DELETE for deleting object modules from a library. 

Format 

LIBRARY/REMOVE libspec global [global [,s]] 

Parameters 

libspec 

Specifies the name of the library from which you wish to remove 
global symbols. 

global [ ,s] 

Specifies the globals you wish to remove from the library. You 
can specify as many as 15 global symbols. 

Example 

>LIBRARY/REMOVE DOUBLE TINKERiEVERSiCHANCE 

Entry points deleted! 

TINKER 

EVERS 

CHANCE 

This example deletes the globals TINKER, EVERS, and CHANCE from 
the library DOUBLE. OLB. 



Notes 



This command is the equivalent of the LBR /DG switch applied to 
the output file. 

If a specified global is not included in the library, the 
following message is printed on your terminal: 

LBR — *FATAL* — No entry point named "name" 

All the global symbols (entry points) in your list up to the 
incorrect name will have been deleted. None of the globals 
following the incorrect name will have been deleted. You should 
use LIBRARY/LIST (Section 6.3.6) to check which globals have been 
deleted and which have not. 



6.3.8 LIBRARY/REPLACE 

LIBRARY/REPLACE replaces a module in a library with a new module of 
the same name and deletes the old module. 

When a match occurs on a module name, the existing module is logically 
deleted and all its entries are removed from the qlobal symbol table. 
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Format 

LIBRARY/REPLACE libspec filespec[ r s] 

Command Qualifiers 

/[NO]GLOBALS 

/SELECTIVEJSEARCH 

/SQUEEZE 

Parameters 

libspec 

Specifies the library in which modules are to be replaced. The 
default file type is .OLB, corresponding to object libraries. If 
you wish to replace macros in a macro library (file type .MLB) or 
a universal library (file type .UNI), you must specify the file 
type explicitly. 

f ilespecf ,s] 

Specifies the file or files containing the new modules. The 
default file type is determined by the type of library in which 
modules are being replaced. It is .OBJ for object module 
libraries, .MAC for macro libraries, and .UNI for universal 
libraries . 

If the module to be replaced does not exist in the library, 
LIBRARY performs an insert operation. 

If the module to be replaced exists, a message is printed. See 
example. If the module does not exist, it is inserted, but no 
message is printed. 

Command Qualifiers 

/[NO]GLOBALS 

/NOGLOBALS specifies that entry points for the specified modules 
are not to be included in the entry point table. The default is 
/GLOBALS. 

/SELECTIVE_SEARCH 

Sets the selective search attribute bit in the module header of 
object modules as they are inserted into an object library. 

Object modules with the selective search attribute are given 
special treatment by the Task Builder. Global symbols defined in 
modules with the selective search attribute are only included in 
the Task Builder's symbol table if they were previously 
referenced by other modules. 

/SQUEEZE 

Reduces the size of macro definitions by eliminating all trailing 
blanks and tabs, blank lines, and comments from macro text. 
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Macros that have been squeezed not only take up less room in the 
macro library file but also take up less memory in the assembler 
when they are invoked. 

See the Notes in Section 6.3 for more information on the /SQUEEZE 
qualifier. 

This is the equivalent of the LBR /SZ switch applied to the input 
file. 

Example 

>LIBR/REPLACE LBOt El , 13SYSLIB USERSUB 

MODULE 'USERSUB' REPLACED 

This example replaces the modules in the file SYSLIB.OLB with new 
modules bearing the same names in the file USERSUB. OBJ. Entry 
points are also redefined. 

Notes 

This command is the equivalent of the LBR /RP command. 

There must be enough space in the library's tables for both the 
modules being replaced and their replacements since the new 
modules are entered before the old modules are deleted. 

The old modules are logically deleted only. You must use 
LIBRARY/COMPRESS to eliminate the modules themselves and free the 
space they occupy. 



6.3.9 Error Messages from LIBRARY 

LIBRARY has two kinds of error messages, diagnostic and fatal. 

Diagnostic messages are marked *DIAG* and inform you of conditions 
that require your consideration but do not warrant termination of the 
command. Depending on the message and the operation, you can decide 
what further action is called for. The operation completes. 

Fatal messages are marked *FATAL* and describe conditions that caused 
LBR to terminate execution of your command. The operation does not 
complete. 

In general, fatal output errors leave the library in an indeterminate 
state. You should use LIBRARY/LIST to determine how much of the 
operation completed before the fatal error occurred. 

Some errors result from corrupted library files. You can use VFY, the 
File Structure Verification utility, to determine whether a file is in 
Files-11 format. A library file can be in Files-11 format and still 
be corrupted as a library, however. 

If a library file is corrupted, the library must be recreated. 
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Error messages appear on your terminal in the following formats: 

LBR — *DIAG*-message 

LBR — *FATAL*-message 

Note that error messages from LIBRARY are tagged LBR after the utility 
and not LIB after the command. This is an exception to the general 
rule on DCL error messages. 

LBR -- Bad library header 

Explanation: The file either is not a library or is corrupted. 

User Action: Make sure the file is a library. If the file is a 
library, use VFY, the File Structure Verification utility, to 
determine if it is corrupted. See Chapter 9 of the 
RSX-11M/M-PLUS Utilities Manual . 

LBR — Command I/O error 

Explanation: There are two possible causes. The problem may be 
with the physical device, such as not being spun up. Or, the 
file may be corrupted or have an incorrect format, such as a 
record length exceeding 132 bytes. 

User Action: Determine the condition that caused the message and 
correct the condition. Reenter the command line. 

LBR — Command syntax error 
command line 

Explanation: The reprinted command line has a syntax 'error. 

User Action: Check for proper syntax and reenter the command 
line. 

LBR — Duplicate entry point name "name" in filename 

Explanation: Your command attempted to insert (not replace) a 
module containing the given entry point name into a library 
already containing an entry point of that name. 

User Action: Make sure you have named the correct input file. 
If not, reenter the command naming the correct input file. If 
the input file is correct, you can delete the duplicate entry 
point from the library and reenter the command. 

LBR — Duplicate module name "name" in filename 

Explanation: Your command attempted to insert (not replace) a 
module with the given name into a library that already contains a 
module of that name. 

User Action: Make sure you have named the correct input file. 
If the input file is correct, you must decide whether or not to 
use LIBRARY/REPLACE to replace the module that is already in the 
library. 
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LBR — EPT or MNT exceeded in filename 

Explanation: The GLOBAL or MODULE table limit has been reached 
during the execution of a REPLACE or INSERT operation. 

User Action: Copy the library using LIBRARY/COMPRESS and include 
the /MNT or /EPT qualifier to increase table size. 

LBR — EPT or MNT space exceeded in compress 

Explanation: A GLOBAL or MODULE table size was specified in a 

COMPRESS operation for the output library file that is not large 

enough to contain the EPT or MNT entries used in the input 
library. 

User Action: Reenter the command line with a larger EPT or MNT 
table size specified. 

LBR — Error in library tables, File "filename" 

Explanation: Either the library is corrupted or it is not a 
library. 

User Action: If the file is corrupted, no recovery is possible. 
The file must be reconstructed. If the file is not a library, 
reenter the command line with the correct file named. 

LBR — Fatal compress error 

Explanation: The input library on a COMPRESS operation is 
corrupted or is not a library. 

User Action: If the file is corrupted, no recovery is possible. 
The file must be reconstructed. If the file is not a library, 
reenter the command line with the correct file named. 

LBR -- Get time failed 

Explanation: System error. LBR attempted to execute a Get Time 
Parameters directive and failed. 

User Action: Reenter the command line. If the error is 

repeated, see your system manager. Plan to submit a Software 

Performance Report. Save console dialogue and other pertinent 
information. 

LBR — Input error on filename 

Explanation: The file system has detected an error. 

User Action: Reenter the command. If the error is repeated, see 
your system manager . 

LBR — Insufficient dynamic memory to continue 

Explanation: The partition in which LBR is running is too small. 

User Action: See your system manager. 
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LER — Invalid EPT and/or MNT specification 

Explanation: Command included an argument for /MNT or /EPT 
greater than 4096. 

User Action: Check for proper syntax and reenter command. 

LBR — Invalid module format, insertion-module 

Explanation: Command attempted to insert the named macro 
definition into an object module library. 

Dser Action: Correct error by reentering command with object 
module for object module library or macro for macro library. 

LBR — Invalid format, input file filename 

Explanation: Your command named either an input file that is not 
in the standard format or a file that is corrupted. 

Dser Action: Make sure you have named the right file and reenter 
command . 

LBR — Invalid library type specified 

Explanation: Your command attempted to set an illegal library 
type as the default. The file types .OBJ and .MAC are the only 
valid default file types for the command. 

User Action: Reenter command after checking proper syntax. 

LBR — I/O error on input file "filename" 

Explanation: A read error occurred on an input file. This error 
can have two causes: 

• A problem with the physical device, such as not being 
spun up. 

• The input file is corrupted or in the wrong format, such 
as records exceeding 132 bytes in length. 

Dser Action: Determine the cause of the error and correct the 
condition. Reenter the command line. 

LBR — Library file specification missing 

Explanation: Your command was entered without "ro^er 
specification of the library file. 

Dser Action: Check for proper syntax and reenter the command. 

LBR — Mark for delete failure on LBR work file 

Explanation: LBR automatically creates a work file when it 
begins processing commands and marks it for delete. For some 
reason this marking failed. The work file is a lost file and 
does not appear in any QFD. 
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User Action: See your operator or system manager. The file must 
be deleted using VFY, the File Structure Verification utility. 
See Chapter 9 of the RSX-11M/M-PLUS Utilities Manual . 

LBR — No entry point named "name" 

Explanation: Your command named an entry point to be deleted 
that is not in the library. 

User Action: Check command for proper syntax and reenter 
command. You may have misspelled the entry point name or named 
the wrong library. 

LBR — No module named "module" 

Explanation: Your command named a module to be deleted that is 
not in the library. 

User Action: Check command for proper syntax and reenter 
command. You may have misspelled the module name or named the 
wrong library. 

LBR — Open failure on file "filename" 

Explanation; The file system detected an error while attempting 
to open a file. This error is caused by one of the following 
conditions: 

• The user directory area is protected against a Write 
operation. 

• There is a problem with the physical device, such as not 
being spun up. 

• The volume is not mounted. 

• The UFD does not exist. 

• The file does not exist. 

• There is insufficient space to allocate the library file 
on a LIBRARY/CREATE or LIBRARY/COMPRESS. 

• There is insufficient pool space (DSR) in the Executive. 

Usee Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 

LBR — Open failure on LBR work file 

Explanation: The file system detected an error while attempting 
to open the LBR work file. The LBR work file is created on the 
volume from which LBR was installed. One of the following 
conditions can cause this error: 

• The volume is full. 

• The device on which the volume is mounted is 
wr i te— orotected ■ 
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• There is a problem with the physical device. 

• There is insufficient pool space (DSR) in the Executive. 

User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 

LBR — Output error on filename 

Explanation: A write error has occurred on the output file. One 
of the following conditions can cause this error: 

• The volume is full. 

• The device on which the volume is mounted is 
wr i te-protected . 

• The hardware has failed. 

User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 

LBR — Positioning error on filename 

Explanation: The device on which the volume is mounted is 
write-locked or some other hardware difficulty exists. 

User Action: Determine the cause of the error if you can. If 
you cannot, see your operator or system manager. 

LBR — Virtual storage requirements exceed 65536 words 

Explanation: This error may occur with maximum size libraries in 
conjunction with a single command line that logically deletes a 
large number of modules and entry points and continues to replace 
them with an equally large number of modules and entry points 
having highly dissimilar names. Normally, this message indicates 
some sort of internal system error. 

User Action: Rerun the job after dividing the command line into 
several smaller lines that perform the same operations. 

LBR — Work file I/O error 

Explanation: A write error has occurred on the LBR work file. 
One of the following conditions can cause this error: 

• The volume is full. 

• The device on which the volume is mounted is 
write-protected . 

• The hardware has failed. 

User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 
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6.4 LINKING THE TASK 

After the MACRO-11 Relocatable Assembler or high-level language 
compiler has translated the source program file into a binary object 
file, the object file must be linked or task built. This process 
makes a runnable task out of one or more object files plus object 
modules from user-written or system library files. 



6.4.1 Introduction to the LINK Command 

The LINK command invokes the Task Builder, a system utility that 
builds the tasks, formally called task images, that run on the system. 

The unadorned LINK command includes a number of defaults that produce 
a standard task image file, having the file type .TSK. The Task 
Builder (TKB) , however, provides you with many choices that are not 
included in the defaults. You can use qualifiers to the LINK command 
to create TKB output files in addition to the task image file, to 
identify certain kinds of unusual tasks, to use hardware options that 
may not be present on all systems, and in general to control the 
nature of the task build itself. In addition to the LINK command 
qualifiers, there are also Task Builder options that permit you to 
specify characteristics of the task you are building. 

The defaults provide you with a simple means of building a standard 
task. You pass the Task Builder an object file (default file type 
.OBJ) produced by the MACRO-11 Relocatable Assembler or one of the 
high-level language compilers, and the Task Builder produces a 
runnable task image. This is done with a command such as the 
following: 

>LINK 

File(s>? SAMPLE 

This command produces a single output file called SAMPLE. TSK. The 
return of the implicit prompt tells you the task build completed 
successfully. 

If, in addition to the task image file, you should want a Task Builder 
map file showing the size and location of parts of the task, issue a 
command such as the following: 

>LINK/MAP SAMPLE 

This produces two output files, SAMPLE. TSK and SAMPLE. MAP. 

SAMPLE. MAP is automatically printed on the line printer and also 
appears in your directory. 

The following command also requests that a map be made: 

>LINK SAMPLE. OBJ/MAP 



This produces two output files, SAMPLE. TSK and SAMPLE. MAP. SAMPLE. MAP 
appears in your directory but is not printed on the line printer. 
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If you are linking more than one object module to form a task, the 
Task Builder, by default, names the output files after the first task 
named in the command line. For example, the command 

>LINK M0E> CURLY i LARRY 
> 

produces a task image file named MOE.TSK. Use the /TASK qualifier to 
change the name of the task image file. For instance, the command 

>LINK/TASKtSHEMP MOE, CURLY t LARRY 

produces a task image file named SHEMP.TSK. Or, use the command 
>LINK MOE j CURLY/TASK, LARRY 

to produce a task image file named CURLY. TSK. 
Note, however, that the command 

>LINK/MAP MOEi CURLY/TASK, LARRY 

produces a task image file named CURLY. TSK and a map file named 
MOE. MAP. 

If, in addition, you want the task build to abort after the Task 
Builder finds three errors, issue a command such as this; 

>LINK/MAP/ERR0R_LIMIT:3 SPARKY 

This produces two output files, the task image and the map, as before. 
In addition, if the Task Builder finds three errors, it sends a 
message to your terminal and aborts the task build. 

Finally, there are Task Builder options. If you specify the /OPTION 
qualifier in your LINK command, you will be prompted for further 
input. For instance, 

>LINK/MAP/OPTIONS BIGJON 
Option? UNITS=7 

The UNITS option specifies the number of I/O units for the task. 

Thf^re* arp mnr^ than t-wr> Ant&n nnt- i nn<z von nan flnorifv Tna\r a-ra 

listed in Table 6-3. 

If you wish to specify options, there are two ways of doing so. You 
must first include the /OPTION qualifier in your LINK command. You 
will be prompted Option? Then: 

1. You can specify options on separate lines. Simply enter an 

option with its arguments and press RETURN. You will be 

prompted Option? until you terminate the prompt with just a 
RETURN. 
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2. You can specify them in a separate file and name the file in 
response to the Option? prompt with an at sign (@) . 

Here are two examples. 

>LINK/MAP/OPTIONS BIGJON ®) 
Option? UNITS=7 (H 
Option? ASG=SYO:fc57 (ED 
Option? © 



>,LINK/MAP/OPTIONS BIGJON © 
Option? eSPARKY.CMD © 
Option? © 

These commands are all DCL commands and the format is DCL format. The 
Task Builder, however, does not recognize DCL format. It recognizes 
only Task Builder format. The translation from DCL format to TKB 
format is performed by DCL. 

Issuing the LINK command to DCL initiates the following process: 

1. DCL reads the command line and checks it for correct DCL 
format. 

2. DCL translates the command line into correct TKB format, 

3. DCL places the TKB-format command in a TKB indirect command 
file and passes the indirect command file to the Task 
Builder. 

4. The Task Builder builds the task as directed and creates all 
requested output files. 

5. The Task Builder returns control to DCL and DCL deletes the 
TKB indirect command file. 

If you are building standard tasks using the defaults and following 
the examples given in the command description (Section 6.4.2), this 
process will serve you well. 

However, you will have to refer to the RSX-11M/M-PLUS Task Builder 
Manual for information on how the Task Builder responds to your LINK 
command. The Task Builder manual explains all the output files 
produced by TKB and how TKB interprets your LINK command. All the 
options are explained in the manual, all the terms used in the TKB 
environment are defined, and, in general, the capabilities of this 
complex and flexible software tool are elucidated. 

The description of the LINK command in this manual is not intended to 

teach you how to use the Task Builder, but only to teach you how to 

use the LINK command. To learn to use the Task Builder, you must go 
to the Task Builder manual. 
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Since TKB format and DCL format are different, this may be difficult 
at first. The TKB translation of your LINK command is available to 
you in two forms. First, you can use the SET DEBUG command (Section 
1.2.15), which echoes on your terminal the translation of any DCL 
command. Second, you can use the /SAVE qualifier to LINK. The /SAVE 
qualifier preserves the indirect command file created by DCL to be 
passed to the Task Builder. This file is named ATLNK.TMP. This file 
is also useful if you wish to repeat a particular task build. See the 
discussion of /SAVE. 

The following description should help you switch from DCL format to 
TKB format. 

In TKB format, you name any output files you want produced, separated 
by commas, to the left of an equal sign (=) . The order you name them 
determines which output files you receive. 

The DCL command 

>LINK SAMPLE, OEJ 

produces the following command in TKB format in the TKB indirect 
command file: 

TKB> SAMPLE. TSK=S AMPLE. OB J 

In each case, the Task Builder takes SAMPLE. OBJ as its input file and 
produces as its only output file the task image SAMPLE. TSK. The task 
image file takes the first position in the list of TKB output files to 
the left of the equal sign (=) . 

The DCL command 

>LINK/MAP SAMPLE. OBJ 
produces the following command in TKB format: 

TKB> SAMPLE . TSK , SAMPLE . MAP = SAMPLE . OBJ 

In each case, the Task Builder takes SAMPLE. OBJ as its input file and 
produces two output files, SAMPLE. TSK and SAMPLE. MAP. The map file 
takes the second position in the list of TKB output files to the left 
of the equal sign. 

The third kind of output file produced by the Task Builder is called a 
symbol definition file and has the file type .STB. 

The DCL command 

>LINK/MAP/SYMBOL_TABLE SAMPLE. OB J 
produces the following command in TKB format: 

TKB> SAMPLE, TSK t SAMPLE. MAP , SAMPLE. STB = S AMPLE. OB J 

In each case, the Task Builder takes SAMPLE. OBJ as its input file and 

produces three output files, SAMPLE. TSK, SAMPLE. MAP, and SAMPLE. STB. 

The symbol definition file takes the third position in the list of TKB 
output files to the left of the equal sign. 
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In TKB format, you can add switches, consisting of a slash and two 
letters, to each of these output file specifications to alter the 
output file. 

For instance, the DCL command 

>LINK/CODEJFIS SAMPLE. OBJ 
produces the following command in TKB format: 

TKB>SAMPLE.TSK/FP=SAMPL„E.OHJ 

In each case, the Task Builder builds a task that uses the Floating 
Point Processor, which is optional hardware. 

Qualifiers can also be used on map files. The DCL command 

>LINK/CROSS_REFERENCE SAMPLE, OBJ 
produces the following command in TKB format: 

TKB>SAMPLE.TSKfSAMF'LE.MAP/C;R = SAMPI...E,OHJ 

In each case, the Task Builder map includes a listing of symbol 

cross-references in the program. DCL does not require you to use the 

/MAP qualifier if you use another qualifier, such as /CROSS_REFERENCE, 

that implies that you want a map file. 

In the description of the LINK command that follows, each DCL 
qualifier is identified with its equivalent in TKB format. 

You can invoke the Task Builder from DCL in four ways: 

• Issuing the LINK command with DCL qualifiers 

• Invoking a DCL indirect command file including a LINK command 
with DCL qualifiers, such as DCL>§LINKFILE 

• Issuing the LINK command and calling a TKB indirect command 
file, such as DCL>LINK @TKBFILE 

• Running the Task Builder with RUN $TKB and issuing TKB 
commands 

The first two methods of invoking the Task Builder require the LINK 
command and DCL format. The latter two methods require commands in 
TKB format. 



6.4.2 LINK 

LINK invokes the Task Builder, which links object modules and routines 
from user and system libraries to form an executable task. 

If you are using LINK with the COBOL-81 compiler, please see Section 
6.4.3, which describes the LINK/C81 command. 
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Format 

LINK [/qualifier [s] ] filespec [/qualifier [s] ] [ ,f ilespec [ ,s] ] 

Command Qualifiers 

/ANCILLARY_PROCESSOR[:n] 
/ [NO] CHECKPOINTrarg 

SYSTEM 
TASK 
/CODE: (arg[,s] ) 

DATA_SPACE 

EAE 

FPP 

PIC 

POSITION_INDEPENDENT 
/COMPATIBLE 
/ [NO] CROSS_REFERENCE 
/ [NO] DEBUG [: filespec] 
/ [NO] EXECUTABLE [ : filespec] 
/ERROR_LIMIT:n 
/[NO] EXTERNAL 
/FAST 

/FULLJ3EARCH 
/[NO] HEADER 
/[NO] IO_PAGE 
/LONG 

/MAP[:f ilespec] 
/ [ NO] MEMORY_MANAGEMENT [ : n ] 
/OPTIONS [ :optionsspec] 
/OVERLAY_DESCR I PT I ON 
/POSTMORTEM 
/[NO]PRIVILEGED[:n] 
/[NO] RECEIVE 
/ [NO] RESIDENT_OVERLAYS 
/SAVE 

/[NO] SEGREGATE 
/SEQUENTIAL 
/SHAREABLE [:arg] 
COMMON 
LIBRARY 
TASK 
/SLAVE 
/SLOW 

/SYMBOL_TABLE [ : f i lespec] 
/[NO]SYSTEM_LIBRARY_DISPLAY 
/ [NO] TASK[:f ilespec] 
/TKB 
/TRACE 

/[NO] WARNINGS 
/WIDE 

File Qualifiers 

/[NO] CONCATENATE 
/DEFAULT_LIBRARY 
/[NO]GLOBALS 
/LIBRARY 

/ iiiv-uuuEn (illuuuici L • • • • illluduienj ) 

/OVERLAY_DESCRIPTION 
/SELECTIVE SEARCH 
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f ilespec[s] 

Specifies the file or files to be linked. The default file type 
is .OBJ for object modules and .OLB for object module libraries. 

You can have any number of object modules as input files, 
separated by commas. These can be specified in any order. If, 
however, one or more input files must reference an object library 
(.OLB) file, the .OLB file must be entered in the list of input 
files directly after the files that reference it. 

Command Qualifiers 

/ANCILLARY_PROCESSOR[:n] 

Identifies the task as an ancillary control processor (ACP) . The 
parameter n specifies the base relocation register. Acceptable 
values are 0, 4, or 5. The default is 5. 

In TKB format, apply the /AC switch to the .TSK filespec. 

/[ NO] CHECKPOINT :arg 

SYSTEM 
TASK 

Specifies that the task is to be (or is not to be) 
checkpointable. Checkpointability of tasks is an important part 
of the operating system's ability to share resources. when a 
higher priority task seeks access to system memory, a 
checkpointable task of lower priority is checkpointed , or rolled 
out to the disk to be stored in its current state until the 
higher priority task exits, whereupon the lower priority task 
returns and takes up where it left off. 

If you do not use the /CHECKPOINT qualifier, your task is built 
noncheckpointable. The default is /NOCHECKPOINT. A 
noncheckpointable task cannot be dislodged by a task of higher 
priority. Therefore, you should always build your tasks 
checkpointable unless you have some important reason for not 
doing so. 

You can specify how the checkpointing of the task is handled 
through the arguments to the /CHECKPOINT qualifier. Your task 
can be checkpointable to the system checkpoint file with the 
SYSTEM option. This is the default. LINK/CHECKPOINT and 
LINK/CHECKPOINT: SYSTEM are equivalent commands. 

Tasks built with system checkpointing cannot be checkpointed if 
the system checkpoint file is full. (The size of this file is 
set with the SET DEVICE command.) 

You can also reserve checkpoint space for the task as part of its 

own task image file by using LINK/CHECKPOINT: TASK. Such tasks 

are always checkpointable. (If there is no system checkpoint 

file, you can only run one copy of such tasks.) 
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It should be apparent that the checkpointability of a task has an 
impact on the efficient operation of the entire system as well as 
on the task itself. If the task is built noncheckpointable, it 
can block more important tasks from running. If it is built with 
task checkpointability, mass-storage space is reserved that may 
never be used. If it is built with system checkpointability, 
there may be no room for it in the system checkpoint file. 

Check with your system manager for advice on the preferred 
selection among these checkpointing qualifiers. 

In TKB format, for /CHECKPOINTrSYSTEM, apply the /CP switch to 
the task image file. For /CHECKPOINT: TASK, apply the /AL switch 
to the task image file. For /NOCHECKPOINT, apply the /-CP switch 
to the task image file. 

/CROSS_REFERENCE 

Specifies that a listing of symbol cross-references is to be 
appended to the Task Builder map file. 

If you include this qualifier, you automatically include the /MAP 
qualifier as well. You do not need the /MAP qualifier unless you 
wish to supply a name for the map file. If you supply a name, 
the map file appears in your current UFD but is not printed on 
the line printer. 

In TKB format, apply the /CR switch to the .MAP filespec. 

/CODE: (arg[,s] ) 

DATA _S PACE 

EAE 

FPP 

PIC 

POSITION_INDEPENDENT 

The /CODE qualifier specifies that the code for the task relies 
on certain hardware elements or employs certain techniques. See 
the RSX-11M/M-PLUS Task Builder Manual for more information. 

The DATA_ SPACE argument (RSX-llM-l'I.PS only) specifics that the 
task employ user-tr.odo I- and D-sspace. in TKB format, apply the 

/ID switch to the .TSK filespec. '", •' ' ' ■ '• ■ ■• : 

The EAE argument specifies that the task uses the Extended 
Arithmetic Element. This hardware is optional and may not be 
part of your system. In TKB format, apply the /EA switch to the 
.TSK filespec. 

The FPP argument specifies that the task uses the Floating Point 

Processor. This hardware is optional and may not be part of your 

system. In TKB format, apply the /FP switch to the .TSK 
filespec. 

The PIC and POSITION_INDEPENDENT arguments are identical and 
specify that the resident common or library being built is 
position-independent. In TKB format, apply the /PI switch to the 
.TSK or .STB filespec. 

If you wish to use more than one argument, enclose them in 
parentheses, separated by commas. 
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/COMPATIBLE 

Specifies that the task be built in compatibility mode. This 
means that memory-resident overlay segments are aligned on 
256-word boundaries for compatibility with other implementations 
of the mapping directives. Without this qualifier, overlay 
segments are aligned on 32-word boundaries. 

In TKB format, apply the /CM switch to the .TSK filespec. 
/DEBUG[ : filespec] 

Specifies the inclusion of a debugging aid in the task image. A 
debugging aid permits you to interrupt the running of a task and 
inspect registers and other memory locations at various stages. 
If you give no filespec, the default is LBO: [l,l]ODT.OBJ, which 
is ODT, the On-line Debugging Tool, a DIGITAL-supplied utility. 
ODT is incorporated in the task you are building. ODT can be 
used only on tasks written in the MACRO-11 Assembly Language. 
See the IAS/RSX-11 ODT Reference Manual for further information. 

If you have a user-written debugger, name the file it is in when 
you use this qualifier. This file should be an object module. 

In TKB format, apply the /DA switch to the .TSK filespec if you 
wish to use ODT. If you wish to use a user-written debugger, 
apply the /DA switch to the input filespec naming the debugger. 

/ERROR_LIMIT:n 

Directs the Task Builder to abort LINK after n diagnostics errors 
have been produced. 

In TKB format, apply the /XT:n switch to the .TSK filespec. 

/[NO] EXTERNAL 

Specifies that the task be built to run with its header out of 
pool. RSX-11M-PLUS only. The default is /EXTERNAL. 

In TKB format, apply the /XH switch to the .TSK filespec. 

/POSTMORTEM 

Requests a Postmortem Dump should the task be terminated 
abnormally. See the RSX-11M/M-PLUS Task Builder Manual for 
information on Postmortem Dumps. 



In TKB format, apply the /PM switch to the .TSK filespec. 



/FAST 



Specifies that the Fast Task Builder be used to build the task. 
The Fast Task Builder is considerably faster than the default 
Task Builder. 
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Several restrictions apply to tasks to be built by the Fast Task 
Builder: 

• Tasks may not be overlaid. 

• Tasks may not be privileged. 

• Tasks may not link to resident libraries. 

• The Task Builder cannot produce an .STB output file. 

• The Task Builder cannot create resident libraries. 

• The LINK command is limited to the following qualifiers: 

- /CROSS_REFERENCE, /MAP, /LONG, /WIDE 

- /[NO] CHECKPOINT: SYSTEM 

- /[NO]MEMORY_MANAGEMENT 

- /CODE:FPP 

- /DEBUG[:f ilespec] 

• The Task Builder is limited to the following options: 

- ASG 

- STACK 

- UNITS 

- EXTSCT 

- ACTFIL 

- MAXBUF 

In addition, the map format is nonstandard and undocumented. 

You can also invoke the Fast Task Builder from DCL with the 
command RUN $FTB. You must follow TKB format if you run the Fast 
Task Builder in this fashion. 

See the RSX-llM/M-PLUS Task Builder Manual for more details. 

/FULL_SEARCH 

Specifies that when processing modules from the default object 
module library, the Task Builder should search all co-tree 
(overlay) segments for matching definitions or references. 

Without this qualifier, unintended global references between 
co-tree overlay segments are eliminated. Definitions of global 
symbols from the default library are restricted in scope to 
references in the main root and the current tree. 

In TKB format, apply the /FU switch to the .TSK f ilespec. 
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/LONG 

Specifies that the map file produced by the Task Builder include 
additional file information on modules used in the task build. 
The long map does not include file information on modules from 
the system library. 

If you include this qualifier, you automatically include the /MAP 
qualifier as well. You do not need the /MAP qualifier unless you 
wish to supply a name for the map file. If you supply a name, 
the map file appears in your current UFD but is not printed on 
the line printer. 

In TKB format, apply the /-SH switch to the .MAP filespec. 

/MAP[ : filespec] 

Specifies that you wish a memory allocation, or map, file 
produced. If you use /MAP as a command qualifier, without a 
filespec argument, the map appears in your UFD with a file name 
derived from the name of the first input file named in the 
command line and a file type of .MAP. The map is also printed on 
the line printer. 

If you use /MAP with a filespec argument, either as a command 

qualifier or a filespec qualifier, the map appears in your UFD 

with a file name you have given. The map is not printed on the 
line printer. 

If you use /MAP as a filespec qualifier, without a filespec 
argument, the map appears in your UFD with a file name derived 
from the name of the .OBJ or .OLB file to which the qualifier was 
attached. The map is not printed on the line printer. 

The following qualifiers automatically direct the Task Builder to 
produce a map with special characteristics: 

/CROSS_REFERENCE 
/LONG 

/SYSTEM_LIBRARY_DISPLAY 
/WIDE 

You do not need the /MAP qualifier with these qualifiers unless 
you wish to add a filespec argument to /MAP. These other 
map-related qualifiers can be used as either command or filespec 
qualifiers, but they have no effect on file names. 

In TKB format, the /MAP qualifier corresponds to the second 
position in the list of TKB output files and has the default file 
type .MAP. 

/[NO] HEADER 

/NOHEADER sets the Task Builder STACK option to 0. If you are 

building a shared region or a driver, you should specify this 

qualifier. If you specify this qualifier, you may not use the 
STACK option. The default is /HEADER. 

In TKB format, apply the /-HD switch to either the ,TSK or .STB 
filespec and specify the STACK=0 option. See /SHAREABLE. 
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/[NO] 10 PAGE 



/NOIO_PAGE indicates to the Task Builder that the task is over 
12K and purposely does not map to the I/O page. This qualifier 
is for building privileged tasks only. The default is /IO PAGE. 

/ [NO] MEMORY_MANAGEMENT [ : n] 

Specifies that the task is being built for a system with (or 
without) memory management hardware. Use the 
/NOMEMORY_MANAGEMENT qualifier when you are building a task on a 
system with memory management to be run on an RSX-11M (or 
RSX-11S) system without the Memory Management hardware. n 
specifies the highest physical address of a task on the target 
system and can be 28 (the default) or 30. 

The default is /MEMORY_MANAGEMENT. 

In TKB format, apply the /-MM switch to the .TSK filespec. 

/SHAREABLE [:arg] 

COMMON 
LIBRARY 
: ASK 

/SHAKKABLErTASK is the default and is for RSX-1 IM-PLUS only. 

/SHAREABLE:COMMON and SHAREABLE: LIBRARY are for RSX-11M/M-PLUS. 

/SHAREABLE: TASK identifies the task as a multiuser task. Such 
tasks permit more than one user to shore the read-only portion of 
* single task. When you specify /SHAREABLE: TASK, "the Task 
Builder divides the task into two regions: region contains the 
read-write portion of the task and region 1 contains »' ? -*e 
read-only portion of the task. When multiuser tasks are 
installed, multiple requests for the task to ran cause the system 
to duplicate >nly the read-write portion of the tusk Cor each 
request after the first.. True ROPAR option permits you to name 
the portion in which region 1 is to reside. in TKB format, apply 
the /MD switch to th?- .TSK filespec. 

On HSX-11M-PLUS systems, ,/SHAREABf ,K: TASK defaults to /SEGREGATE. 

/SHAREABLE: COMMON informs the Task Builder that a shareable 
common is being built. You should always use the /NOHEADER 
qualifier with /SHAREABLE:COMMON. If you do not specify C0DE:PIC 
or CODE:POSITION_INDEPENDENT, TKB builds an absolute shared 
common. All program sections in the common are marked absolute. 
If you specify CODE: PIC or CODE: POSITION_INDEPENDENT, all program 
sections in the common are marked relocatable. In either case, 
the .STB file contains all the program section names, attributes, 
lengths, and symbols. The .STB file of a common built /SHAREABLE 
contains all defined program sections. In TKB format, apply the 
/CO switch to the .TSK or .STB filespec. On RSX-11M-PLUS 
systems, /SHAREABLE: TASK defaults to /SEGREGATE. 

/SHAREABLE: LIBRARY informs the Task Builder that a shareable 
library is being built. You should always use /NOHEADER with 
/SHAREABLE: LIBRARY. TKB includes only one program section in the 
•STB file. If you do not specify C0DE:PIC or 
CODE:POSITION_INDEPENDENT, TKB names the program section .ABS, 
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makes the library position-dependent, and defines all symbols as 
absolute. If you specify CODE:PIC or CODE: POSITION_INDEPENDENT, 
TKB gives the program section the same name as the root segment 
of the library. TKB forces this name to be the first and only 
declared program section in the library. TKB declares all global 
symbols in the .STB file relative to that program section. In 
TKB format, apply the /LI switch to the .TSK or .STB filespec. 

/OPTION [ :optionsspec] 

Specifies one or more Task Builder options. Use this qualifier 
if you need to use any of the Task Builder options. Information 
on these options is summarized in Table 6-3. See Section 6.4.1 
for information on using this qualifier. For full information, 
or options, see the RSX-11M/M-PLUS Task Builder Manual . 

You can supply options for this qualifier in two ways: you can 
supply the filespec of a file containing the options, or you can 
specify the options themselves. If you do not include a filespec 
with this qualifier, you are prompted for options. If you wish 
to enter multiple options, you must use a comma after each option 
listed. If you wish to list multiple options on individual 
lines, you must end each line with a comma. 

If you include a filespec with this qualifier, this file should 
contain only the option names, comments, and the arguments 
associated with the options, as shown: 

[JNITS=8 

ASG=TT0:7:8 

; COMMENTS, PRECEDED BY SEMICOLON, ALLOWED 

PAR=KROBAR: 50000: 40000 

This file should not include anything but the option statements 
and comments preceded by the semicolon (;). Comments preceded by 
the exclamation point (!) are not accepted in this instance. Do 
not put any slashes in this file. 

Note that the ABORT option is the only means of preventing a task 
build once you have begun issuing commands to the Task Builder. 
A CTRL/Z simply directs the Task Builder to begin the task build 
based on whatever instructions you have issued up to that point. 
Thus, if you want to be sure of being able to stop a task build 
in this way, you must include the /OPTIONS qualifier in the LINK 
command line. This assures the availability of the ABORT option. 
If you are typing the command line and make a mistake, specify 
the /OPTIONS qualifier, press RETURN, and enter the ABORT=0 
option. Then press RETURN and the task build aborts. 

/OVERLAY_DESCRIPTION 

Specifies that the input file is an overlay description file 
(type .ODL) that controls the linking of the task. No other 
input file can be specified if you use this qualifier. The .ODL 
file specifies input files to LINK. /OVERLAY_DESCRIPTION can be 
either a command qualifier or a filespec qualifier. 

In TKB format, use the .ODL file as the only input file to the 
right of the equal sign (=) with the /MP switch applied to the 
.ODL filespec. 
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/PRIVILEGED! :n] 



Indicates that task is privileged. The argument n specifies the 
base relocation register. Acceptable values are 0, 4, or 5. The 
default is 5. 

In TKB format, apply the /PR switch to the .TSK filespec. 
/[NO] RECEIVE 

Indicates that the task may (or may not) receive messages by 
means of the Executive directive SEND. /RECEIVE is the default. 

In TKB format, apply the /SE switch to the .TSK filespec. 

/ [ NO] RESIDENT_OVERLAY 

Enables (or disables) recognition of the memory-resident overlay 
operator (!) in an overlay description file. The qualifier is 
used with the /OVERLAY_DESCRIPTION qualifier when the task has 
memory-resident overlays. The default is /RESIDENT_OVERLAY. 

In TKB format, apply the /RO switch to the .TSK filespec. 

/SAVE 

The /SAVE qualifier specifies that you wish to retain the 
indirect command file created by DCL to pass your LINK command to 
TKB. See Section 6.4.1 for a description of DCL's handling of 
the LINK command. If you include /SAVE in your LINK command 
line, a file named ATLNK.TMP appears in your UFD after the task 
build completes. Since this file always has the same name, you 
should give it a name related to the task it builds, such as 
SHEMPBLD.CMD. Then you can issue a command in the form 

>LINK eSHEMPBLO 

and duplicate the task build that originally produced the command 
file. 

This file is also useful for comparing LINK command syntax with 
TKB syntax because it includes the full translation of the LINK 
command into TKB format. 

/[NO] SEGREGATE 

/SEGREGATE causes the Task Builder to order program sections 
alphabetically by name within access code (RO followed by RW) . 
If you also specify /SEQUENTIAL, TKB orders "ro^ram sections in 
their input order by access code. 

/NOSEGREGATE is the default. TKB interleaves RO and RW program 
sections. When combined with /SEQUENTIAL, /NOSEGREGATE results 
in a task with program sections allocated in input order with its 
RW and RO sections interleaved. If you use /NOSEQUENTIAL and 
/NOSEGREGATE together, which is the default for both, TKB orders 
program sections alphabetically with RW and RO sections 
interleaved . 

In TKB format, use the /[-]SG switch on the .TSK filespec. 

On RSX-11M-PLUS systems, /SHAREABLE: TASK defaults to /SEGREGATE. 
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Table 6-3 
Task Builder Options 



Description and 
-l 
Language Key- 1 - 



Format and Defaults 2 



Control 



Direct TKB to terminate 
build (M,H) 



ABORT=0 

Number used for format only, 
number will do. 



Any 



Identification 



Declare task name (M,H) 



TASK=l-6 alphanumeric characters 
TASK=first six characters of first 
file name 



Set task's User Iden- 
tification Code (M,K) 

Declare task's priority 
(M,H) 



Declare task's partition 
name and size (M,H) 

Declare the partition in 
which the read-only 
portion of a multiuser 
task is to reside (M,H) 

Declare the completion 
routi'.". :':>e supervisor 
mode library will use to 
return control to /our 
program in user re«Kte 'M,H> 



UIC=[g,m] 
OlC'terminal UIC 

PRI=decimal integer 1-250 
PRI=set by INSTALL; 50, for 
nonpr ivileged users 

PAR=parname[ :base : length] 
PAR=GEN 

RQPAR=pa cname 
■ROPAR=GEN 



CMPHT=l-6 alphanumeric characters 
Kto default .;. ~ ;:'- ; ".. ,.:-.:'"; ';..,'-■■ 



1. Language key: 

M - Option is of interest to MACRO-11 programmers. 
H - Option is of interest to programmers using 
languages . 



high-level 



2. The first entry in the format and default column gives the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 
You must read the RSX-11M/M-PLUS Task Builder Manual for full 
information on these options. 

(Continued on next page) 
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Description and 
Language Keyl 



Format and Defaults 2 



Declare number of active 
files (H) 

Declare extension to 
FORTRAN record buffer (H) 



Declare extension of 
buffer used for process- 
ing format strings (H) 



Declare extension of 

program section (M,H) 

Declare extension of 
task's portion of memory; 
extends D-space of I- 
and D-space tasks 
(M,H) 

Declare virtual base 
address and size of 
virtual program section (H) 

Declare number of addi- 
tional window blocks 
needed by task (M,H) 

Declare size of stack 
<M,H) 



ACTFIL=decimal integer 
ACTFIL=4 

MAXBUF=decimal integer for record 
size in bytes (larger than 
default) 

MAXBUF=13 2. 

FMTBUF=decimal integer for number 

in longest format description 
(larger than default) 

FMTBUF=132 

EXTSCT=psectname :extension 
No default 

EXTTSK=decimal integer for increase 
in task memory allocation (in 
words) 

Default from PAR option 



VSECT=psectname:base:window[ : length] 
No default 



WNDWS=0-5 

WNDWS=0 



STACK=decimal integer for number of 

words needed for stack 
STACK=256. 



1. Language key: 

M - Option is of interest to MACRO-11 programmers. 
H - Option is of interest to programmers using 
languages . 



high-level 



2. The first entry in the format and default column gives the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 
You must read the RSX-11M/M-PLUS Task Builder Manual for full 
information on these options. 

(Continued on next page) 
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Table 6-3 (Cont.) 
Task Builder Options 



Description and 
Language Keyl 



Format and Defaults ^ 



Sharing Storage 



Declare intention to 
access system-owned 
common block for 
data in memory; if 
used with I- and 
D-space tasks, common 
mapped with D-space 
APRs only (M,H) 

Declare intention to 
access system-owned 
resident library for 
code; if used with 
I- and D-space tasks, 
library mapped with 
I- and D-space APRs 
(M,H) 

Declare intention to 
access user-owned common; 
if used with I- and 
D-space tasks, common 
mapped with D-space APRs 
only (M,H) 

Declare intention to 
access user-owned library; 
if used with I- and 
D-space tasks, library 
mapped with I- and 
D-space APRs (M,H) 



COMMON=name:access-code [ :apr ] 
No default 



LlBR=name: access-code [ :apr] 
No default 



RESCOM=f ilespec/access-code [ :apr] 
Standard defaults on filespec 



RESL I B=f ilespec/access-code [ :apr] 
Standard defaults on filespec 



1. Language key: 

M - Option is of interest to MACRO-11 programmers. 
H - Option is of interest to programmers using 
languages . 



high-level 



2. The first entry in the format and default column gives the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 
You must read the RSX- 1 IM/Mt- PLUS Task Builder Manual for full 
information on these options. 

(Continued on next page) 
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Description and 
Language Key! 



Format and Defaults2 



De rleir& i n t e n t i o n t o 
access a user-owned 
;upervi jo: mode library 

(m,hj ^ „', ■, ■ . .: ".,'.; 

Allow task to dynamically 
map memory-resident 
shared regions at 
run time. One task 
address window maps 
the libraries into 
the same span of virtual 
address soace* (M,H) 



RESSUP=filespec/[-]Sy[:apr] 

S1 a idai 3 def au Its on L i 3 espec 



CLSTR=libraryl,library2, . . .libraryn : switch : [apr] 
libraryl is default library 
switch can be RW: or RO: 
apr is starting APR 
No default 



Dec 1 a r e i n f;e a 1 1 on to 
access ■-. system-owned 
supervisor mode library 
(M,H) ■ . .. ,' ;'. 



SUPLIB= f i 1 espec/ | - ] SV [ : apr ] 
Standard defaults or. fiiespec 



Device 



Declare number of I/O 
(logical) units (M,H) 

Declare logical device 
assignment to units (M r H) 



UNITS=decimal inteqer 0-250 
UNITS=6 

ASG=ddnn:unit-num:unit-num . 
ASG=SY0:1:2:3:4,TI0:5,CL0:6 



Alterations 



Declare definition of 
global symbol (M) 



GBLDEF: symbol -name : symbol -value 
No default 



1. Language key: 

M - Option is of interest to MACRO-11 programmers. 
H - Option is of interest to programmers using 
languages . 



high-level 



2. The first entry in the format and default column gives the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 

Vnn must- raar\ 4-ho ORY.llM/M.Dr.nS Taolr Tlnil^ar Ms,.-., , = 1 fm- f,^,^^ 



information on these options. 



(Continued on next page) 
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Table 6-3 (Cont.) 
Task Builder Options 



Description and 
Language Key-'- 



Format and Defaults 



Declare global symbol 
reference (M) 

Declare series of patch 
values; patches I-space 
of I- and D-space 
tasks (M) 

Declares series of patch 
values; patches D-space 
of I- and D-space tasks 
(M) 

Declare series of patch 
values relative to global 
symbol (M) 

Exclude the specified 
symbols from the symbol 
definition file of a 
supervisor mode library 
(M) 

Declare address and size 
of ODT SST vector (M) 

Declare size of task SST 
vector (M) 

Include specified symbols 
in .STB file (M,H) 



GBLREF=symbol-name 
No default 

ABSPAT=seg-name:address :val-l 

(up to 8) 
No default 



DSPPAT=seg-name: address : val-1 

(up to 8) 
No default 



GBLP AT=seg- name :sym-name [+/-of f set] : val-1 

(up to 8) 
No default 

GBLXCL=syml:sym2: . . . :sym8 
No default 



ODTV=symbol -name: vector- length 
No default 

TSKV=symbol -name: vector- length 
No default 

GLBINC=symbol-name, symbol-name, . . . , symbol-name 
No default 



1. Language key: 

M - Option is of interest to MACRO-11 programmers. 
H - Option is of interest to programmers using 
languages . 



high-level 



2. The first entry in the format and default column gives the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 
You must read the RSX-11M/M-PLUS Task Builder Manual for full 
information on these options. 
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/SEQUENTIAL 

Directs Task Builder to construct a task image from program 
sections in the order in which they appear. Normally, the Task 
Builder finds all program sections referenced in all modules in 
an overlay segment and then builds the task with those program 
sections in alphabetical order. Do not use this qualifier to 
build tasks that rely on alphabetical allocation of program 
sections, such as FORTRAN I/O handling modules and FCS modules 
from SYSLIB. See also /SEGREGATE. 

In TKB format, apply the /SQ switch to the .TSK filespec. 
/SLAVE 

Specifies that the task is to be slaved to a sending task. When 
a slaved task successfully executes the Executive directive 
Receive Data, it is given the UIC and TI : of the sending task. 
This qualifier applies only to systems with multiuser protection. 

Slaved tasks cannot be run with a RUN command. They must be run 
by the sending task. 

In TKB format, apply the /SL switch to the .TSK filespec. 
/SLOW 

Invokes the Slow Task Builder. You should specify the Slow Task 
Builder only if your link or task build produces the following 
error message: 

NO VIRTUAL MEMORY STORAGE AVAILABLE 

The default Task Builder and the Fast Task Builder use a symbol 
table structure that can be searched quickly, but which requires 
more work file space than the Slow Task Builder. If you receive 
the error message shown, you have the choice of reducing 
work-file size as described in the Task Builder manual or of 
using the Slow Task Builder. 

Except for the use of different symbol table structures, the 
default Task Builder and the Slow Task Builder are identical. 
All qualifiers to LINK and all TKB options are available for the 
Slow Task Builder. 

You can also invoke the Slow Task Builder from DCL with the 
command RUN $STK. You must follow TKB format if you run the Slow 
Task Builder in this fashion, 

/SYMBOL_TABLE[ : symbol tablespec] 

Directs that a symbol table file be produced. The default name 
is that of the first input file and the default type is .STB. 
The filespec parameter overrides the defaults. This qualifier is 
used when building shared regions. 

In TKB format, this qualifier corresponds to the third position 
in the list of TKB output files, called the .STB filespec. 
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/ [NO] SYSTEM_LIBRARY_DISPLAY 

Directs the Task Builder to produce a map that includes (or does 
not include) global symbols defined or referenced by the task. 
These symbols are found in LBO: [1, 1] SYSLIB or in any shared 
regions linked to using TKB options. This map is usually 
considerably longer than the default map. The information 
displayed illuminates the contribution that SYSLIB or the shared 
regions make to the task. 

If you include this qualifier, you include the /MAP qualifier as 
well. You do not need the /MAP qualifier unless you wish to 
supply a name for the map file. If you supply a name, the map 
file appears in your current UFD but is not printed on the line 
printer . 

See the RSX-11M/M-PLUS Task Builder Manual for more information. 

In TKB format, apply the /MA switch to the .MAP filespec. 

/TASK[ :taskspec] 
/EXECUTABLE [:taskspec] 

Specifies a name for the task image file different from that of 
the first input file plus the type .TSK. If used as a filespec 
qualifier, the task name is derived from the name of the file to 
which the qualifier is attached. /EXECUTABLE is a synonym. 

In TKB format,- this oualifier corresponds to the first position 
in the list of TKB output files, called the .TSK filespec. 

/NOTASK 
/NOEXECUTABLE 

Specifies that LINK produce no task image file. This qualifier 
is useful when you wish to use some facility of the Task Builder 
without building a task, to check for unresolved symbol 
references or make a map, for instance. /NOEXECUTABLE is a 
synonym. 

In TKB format, leave the first position in the list of TKB output 
filespecs blank, followed by a comma {,). 



/TKB 



Specifies that the default Task Builder be used to build the 

task. This is the default; the qualifier is included for 
completeness . 

You can also invoke the default Task Builder from DCL with the 

command RUN $TKB. You must follow TKB format if you run the 
default Task Builder in this fashion. 



/TRACE 



Specifies that the task is to be traceable, 
qualifier, a trace trap occurs on the 
instruction when the task is run. 



When you use this 
completion of each 



In TKB format, apply the /TR switch to the .TSK filespec, 
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/[NO] WARNINGS 

/NOWARNINGS suppresses diagnostic messages issued by the the Task 
Builder. Two messages are suppressed: 

n undefined symbols segment "segname" 

and 

Module "modulename" multiply defines P-section "psectname" 

The default is /WARNINGS. 

In TKB format, use the /[-]NM switch on the .TSK filespec. 

/[NO]WIDE 

Specifies that the Task Builder map be printed in 132-column 
format. The default is /NOWIDE. 

If you include this qualifier, you include the /MAP qualifier as 
well. You do not need the /MAP qualifier unless you wish to 
supply a name for the map file. If you supply a name, the map 
file appears in your current UFD but is not printed on the line 
printer. 

In TKB format, apply the /WI switch to the .MAP filespec. 

Parameter Qualifiers 

Any input file can have a parameter qualifier applied to it, 
identifying the kind of file that it is. 

/[NO] CONCATENATE 

Identifies the input file as a concatenated object file; this is 
the default. All modules in the file are processed to form the 
task image. /NOCONCATENATE specifies that only the first object 
module encountered is to be processed, regardless of how many are 
present. 

In TKB format, apply the /CC switch to an input file containing 
concatenated object modules. 

/LIBRARY 

Identifies the file as an object module library. This qualifier 
is required for any input library file and is prohibited for any 
other type of file. The default file type for "object libraries 
is .OLB. 

The Task Builder searches the library file to resolve all 
undefined global symbol references from files appearing to the 
left of the library file in the LINK command line. The Task 
Builder then extracts any and all modules that resolve undefined 
references and includes them in the task image. See also 
/INCLUDE. 
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/INCLUDE rmodulel [ : . . .modulen] 

You can specify as many as eight module names from a library 
using /INCLUDE. You must specify at least one. If you use the 
optional module arguments, the Task Builder takes only those 
modules from the library. The module names are defined at 
assembly time. 

If you wish both to resolve undefined references to global 
symbols and to specify modules, you must use this qualifier 
twice. 

In TKB format, apply the /LB switch to an input library file for 
both /LIBRARY and /INCLUDE. 

/DEFAULT_LIBRARY 

Specifies that the file to which it is appended replace the 
system object module library, LBO: [1,1] SYSLIB.OLB, as the default 
library that is searched to resolve unresolved global references. 
This qualifier can be applied to only one file and that file must 
be an object module library, type .OLB. 

In TKB format, apply the /DL switch to an input library file. 

/[NOJGLOBALS 

Specifies that global symbols referenced and defined by the input 
file are (or are not) to be included in the map output file. The 
default is /GLOBALS. 

In TKB format, apply the /-MA switch to the input file. 

/SELECTIVE_SEARCH 

Instructs the Task Builder to search the file only for undefined 
references to global symbols. This qualifier is most useful when 
building an Ancillary Control Processor or other privileged task 
that maps into the Executive. If you do not specify this 
qualifier, all the Executive's global symbol definitions are 
included in the task build, whether there are undefined 
references to the global symbol or not. The Executive contains a 
myriad of modules. In these and similar circumstances, this 
qualifier considerably shortens the symbol table search and 
improves system performance. 

If you do not use this qualifier, all global symbols from the 
input file are included in the task image. 

In TKB format, apply the /-SS switch to an input file. 

Examples 

>LINK 
File(s)? WRAY 

This example task builds the object file WRAY. OBJ into the task 
imaae file WRAY.TSK. For the LINK command to work properly, 
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WRAY.OBJ must be an object file. Since the user did not specify 
a file type for the object file, the LINK command supplied the 
default file type .OBJ. 

The return of the implicit prompt indicates successful completion 
of the task build. 



>LINK WRAY 
This example is equivalent to the previous one. 

>LINK/MAP WRAY 

This example is similar to the previous two except that a Task 

Builder map is also requested. When the task build is completed, 

the map WRAY.MAP is printed on the line printer and also appears 
in your directory. 

>LINK/MAP{NEWL.INK WRAY 

This example is similar to the previous one, except that a 
filespec is provided with the /MAP qualifier. When the task 
build is completed, the map file NEWLINK.MAP appears in your UFD. 
If you want a copy of this file, issue a PRINT command. 

>LINK URAY/MAP 

This example illustrates another way of using the /MAP qualifier. 
In this case, when the Task Builder exits, a file called WRAP. MAP 
appears in your UFD but is not printed on the line printer. If 
you want a copy of this file, issue a PRINT command. 

>LINK/DEBUG WRAY 

This example builds the task WRAY.TSK including ODT, the On-line 
Debugging Tool. 

>LINK/0PTI0NS WRAY © 
0ptiar,?UNITS-8 (SHI 
Qption?ASG=TT0:7J8 ®) 
Option? (RET) 

This example illustrates the use of the /OPTIONS qualifier. The 
command sequence builds the task with eight logical units (LUNs) , 
with LUNs 7 and 8 assigned to TTO:. See the discussion in 
Section 6.4.1. The entire LINK command is entered by the final 
RETURN in response to the Option? prompt. 
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>L INK/OPT I0NS/N0MEM0RY_MAN WRAY 
Option?PAR = KROBARt 50000*. 40000 

This example builds the task to run on an unmapped system in the 
partition named KROBAR, which has a base address of 50000 and a 
size of 40000. 



^link/checkpoint: system wray 
>link/checkp0int wray 

The commands in this example are equivalent. The task is built 
checkpointable to the system checkpoint file. 

>LINK/CHECKP0INTITASK WRAY 

In this example, the task is built with checkpoint space reserved 
where the task image file is stored. 

>LINK WRAYr 3TRACK 

In this example, the task is built from two object modules, 
WRAY. OBJ and 3TRACK.OBJ. The task image file has the name 
WRAY.TSK. It is installed and run under that name. 

>LINK/TASKt SHACK WRAY, 3TRACK 

In this example the task is built from the same two object 
modules as in the previous example. However, the task image file 
is given the name SHACK. TSK by the /TASK qualifier. It is 
installed and run under that name. 



>LINK/0PTI0NS WRAY, 3TRACK 
Option?TASK=SHACK 

S' 

In this example, the task is built from two object modules. The 

task image file has the name WRAY.TSK, but the default task name 

{specified by the TASK option) is SHACK. The default task name 

is used by the INSTALL command (see Section 7.8) if the user does 

not specify a task name explicitly. Only privileged users can 

issue the INSTALL command. This means that to run the task from 
a file, you use the command RUN WRAN, but if you run it after it 
has been installed, you use the command RUN SHACK. 

>LINK/0vERLAY RAYMEN 

In this example, the Task Builder uses the file RAYMEN. ODL to 
build an overlaid task. (.ODL is the default file type for the 
/OVERLAY qualifier.) The input file RAYMEN. ODL must be written in 
the Overlay Description Language. Only one file can be specified 
with this qualifier. The files that form the overlaid task are 
i-allorl ai.i torna t i r.a 1 ] L v . 
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>LINK BWRAYBLD 

This example specifies the indirect command file WRAYBLD.CMD as 
input to the Task Builder. This file must be written in Task 
Builder format, not DCL format. This file can be the ATLNK.TMP 
file renamed. See the discussion under /SAVED. 



Notes 



You must read the appropriate documentation to use 
fully. This is true without exception. 



this command 



The RSX-11M/M-PL US Task Builder Manual 

"link." 

"build." 



does not use the term 

In the Task Builder manual, the preferred term is 



Note that nonprivileged users can build privileged tasks and 
high-priority tasks, but those users cannot run the privileged 
tasks. Nor can they run tasks at any but the default priority of 
50. 

Remember that for nonprivileged users, the RUN command is always 
a combination of three commands. In effect, it is an 
INSTALL-RUN-REMOVE command. Thus, references to installation in 
the preceding discussion refer to explicit installation by 
privileged users through the INSTALL command and implicit 
installation through the RUN command as well. See Chapter 7 for 
further details. 

You can include comments in the LINK command line in the usual 
DCL fashion. However, comments in a list of TKB options must 
appear on a line by themselves preceded by a semicolon. Do not 
use the exclamation point (!) for comments in a list of options. 

Error Message 

LIN — Library invalid on last input file 

Explanation: The syntax of LINK requires that the last input 
file specified must be a valid (single) object file that is not 
part of a library. 

User Action: Check for proper syntax and reenter the command. 



6.4.3 LINK/C81 

This section explains how you can link COBOL-81 object files to 
produce a task image (.TSK file). 

Format 

LINK/C81 [/qualifier [s] ] filespec[ ,s] 
LINK/COBOL[/qualif ier [s] ] filespec[ ,s] 
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Command Qualifiers 

Although the format shows them as command qualifiers, you can 
append the following qualifiers to either the command or a file 
specification. When you use the LINK/C81 command, the two 
locations are equivalent. 

/[NO]FMS 
/FMS:NORESIDENT 
/OTS: [NO] RESIDENT 
/[NO] RMS: [NO] RESIDENT 
/[NO] MAP 
/[NO] DEBUG 

Parameter 

f ilespec[ ,s] 

Specifies the file or files to be linked. The default file type 
is .SKL. 

The LINK/C81 command links object modules indirectly through 
their associated .SKL files. Therefore, if you include file 
types in any file specifications, you must use .SKL rather than 
.OBJ. Each .SKL file corresponds to an object module (.OBJ file) 
that is included in the task image. Except for the file type, 
the .SKL file and object module have identical file 
specifications . 

You can list any number of .SKL files as input files in any 
order, separated by commas. 

Qualifiers 

/OTS: [NO] RESIDENT 

The /OTS:RESIDENT qualifier includes memory-resident OTS in your 
task image. When you specify /RMS: RESIDENT as well as 
/OTS: RESIDENT, LINK/C81 clusters these two libraries by default. 
If you can take advantage of the clustering feature, the 
resulting task image is smaller and program execution speed is 
improved. However, do not use /OTS: RESIDENT if memory-resident 
OTS is not installed on your system because an error condition 
will result. 

The /OTS:NORESIDENT qualifier includes the disk-resident OTS 
library in your task image. 

The default is /OTS:NORESIDENT. 

/[NO]RMS: [NO]RESIDENT 

The /RMS:RESIDENT qualifier creates a reference to the shared 
RMS-11 memory-resident library, RMSRES. This library includes 
input/output support for sequential, indexed, and relative file 
organizations . 
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When you specify /OTS:RESIDENT as well as /RMS: RES I DENT, LINK/C81 
clusters these two libraries by default. If you can take 
advantage of the clustering feature, the resulting task image is 
smaller and program execution speed is improved. However, do not 
use the /RMS:RESIDENT qualifier if memory-resident RMS is not 
installed on your system because an error condition will result. 

The /RMS:NORESIDENT qualifier includes the disk-resident RMS 
overlays in your task. By default, LINK/C81 provides the 
smallest RMS overlay structure available. This provides you with 
the smallest task image you can achieve using disk-resident RMS 
overlays. 

The /NORMS qualifier is equivalent to /RMS:NORESIDENT. 
/[NO] MAP 

The /MAP qualifier causes LINK/C81 to produce a Task Builder map 
file with the file type .MAP. 

The /NOMAP qualifier tells LINK/C81 not to produce a memory map 
file. 

The default is /NOMAP. 

/[N0]DEBUG 

The /DEBUG qualifier tells LINK/C81 to include the C0B0L-81 
Symbolic Debugger in your task image. 

To use this qualifier, you must also use the /DEBOG qualifier to 
the COBOL command (see Section 6.2.4.1). 

The /NODEBUG qualifier tells LINK/C81 not to include the C0B0L-81 
Symbolic Debugger in your task image. 

The default is /NODEBUG. 

/[NO]FMS 
/FMS:NORESIDENT 

The /FMS qualifier causes LINK/C81 to include Forms Management 
Services (FMS) library support in your task image. You must use 
this qualifier if you call FMS routines from your program. 

The /NOFMS qualifier tells LINK/C81 not to include FMS support. 

The default is /NOFMS. 

The /FMS:NORESIDENT qualifier causes LINK/C81 to include support 
for a non-memory-resident FMS library in your task image. Since 
no resident FMS libraries are supported under RSX, this qualifier 
is equivalent to /FMS. 

For more detailed information about how to create a task image using 
LINK/C81, refer to the C0B0L-81 RSX- 11M/M- PLUS User's Guide. 
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6.5 DEBUG : "- : -.... ...'■■"" ; .-;;■ ■-/"■■;; ■ ..,;-"- ,,./-'- / .\ i :. ■ ' ;■„,,. '= <• 

DEBUG torcos a task on an RSX-11M-PLUS system to trap to a debugger by 
sotting the T-bit in the task's Processor Status Word. The task must 
nave been built using the /DfcHUG qualifier to the LINK command or have 
issued the SVDB$ Executive directive (Specify SST Vector Table for 
Debugging vftid).; '". ;■■.:,;'"';.'•:'■ ""/ ■',■:.* ■'■'"•~ '. ■ •"!""\ : '"'.. ■..,";"■ : 

Nonprivileged users can issue this command for any nonprivileqed task 
running trom their terminals. privileged users aan name any task, but 
th.--- command must be issued from the same terminal the task was run 



Format „,:, ■ . """ ; ■ •,, '*''■ ■ ., ■ ,,, ' ■ 

•,■; DEBUG [taskname] "''■..*/. «, "/ '■•■I,..' ""':.. ' '" ," ' ■ 

Parameter 

taskname 

Specifies the name oE the task you wish to trap. If you do not 
specify a task name, the default is a task named after the 

terminal from which the command Was, issued, such: as TT56. 



Example 



>RUN JOE 

VSMOU TASKR/ACTTUf: 
MCR, ♦•■♦ <TT565 ) 

SHO'T.56 (TT56 5 ) 

TT56 CTT56'; ) 



'■ DEBUG 
TE:002452 



In this example, the task was built including ODT. The user 
issued:, the DEBUG command, .which; defaulted to the task named after 

the .terminal. '.'/ The display from QDT gives the T-blt ;: , exception 
code , and .the address fol lowing the location' in error and' issues 

Its' prompt . ■■ ,. "The, 'user can-' proceed with ^debugging,,; -DDT ,is 

documented in the iAs/RSX-li 0!ii' Refer ence Ma nua l . 



Notes 



The DEBUG command is uset'ul when a tack is eaug,ht in ah infinite 
loop between breakpoints or is waiting for an incorrect or 
nonexistent event flag. • ,"/'"",,,'. ■ ■>,; 

See th-- RSX-1 1M/M-PLUS Executive Reference Manual Eoi information 
on the SVDB$ "directive . "' ■ . 

The /DEBUG qualifier to, the LINK command is equivalent to the /DA 

"switch;" on ''a. TKB command. See also ' the RS X-11M /M- PLUS Task 

Builder Manual. ■.;'' -','/*» " 
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Knot Messuye . ' ;>■*■■ ■,.■'.-„. ™- ■ . *• W7'\_' !i . 

"time" *** "taskname" does not contain a debugging aid 

explanation: an, attempt was made to debu<j a task that was noi 
".'• • ; • bu i ]. t w i th ' .'a debugging a id .. " 7 " [ \ '; ' • ..<.,'. , ' ' "." ■ - • ' ; ■"" ; ; , • ■ ....... ' , 

User Action: None- This cannot be done. 



6.6 SET AND SHOW 

You can set and show group global event flags. These are a set of 32 
global event flags available only to tasks run from one group of UICs. 
Otherwise, these flags are identical to other global event flags. 
Event flags are used for communication between tasks. See the 
RSX-11M/M-PLUS Executive Reference Manual for further information. 



6.6.1 SET GRODPFLAGS 

SET GROUPFLAGS creates and deletes group global event flags. 

Privileged users can create and delete group global event • flags for 
any group. Nonpr i vileged users can create and delete global event 
flags for the group of which they are members. 

Format 

SET GROUPFLAGS [/qualifier] 
Flag? n 

SET GROUPFLAGS:n [/qualifier] 

Command Qualifiers 

/CREATE 
/DELETE 

Command Qualifiers 

/CREATE 

Specifies that you wish to create a set of group global event 
flags. This is the default and need not be specified. 

n is the group with which the flags are associated.. 
Nonprivileged users can create and delete group global event 
flags for their own login group. Privileged users can create and 
delete group global event flags without restriction. 

/DELETE 

Specifies that you wish to delete a set of group global event 
flags, n is the group with which the flags are associated. 
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Example 



>SH0W GROUPFLAGS 

7 000000 

200 000000 

> 

>SET GROUPFLAG 

F13SS? 303 

>SH0W GROUPFLAG 

7 000000 

200 000000 

303 000000 

In this example, the user first displayed all the current group 
global event flags on the system and found that there were two 
sets but none for the user's group, which was 303. Then the user 
created a set of group global event flags for his group and 
verified their presence with the SHOW GROUPFLAGS command. 



6.6.2 SHOW GROUPFLAGS 

SHOW GROUPFLAGS displays the group global event flags currently in the 
system. 

Format 

SHOW GROUPFLAGS 
Example 

>SH0W GROUPFLAGS 



7 I 


L 000000 


000000 


200 ] 


000000 


000000 


201 : 


L 000000 


000000 


303 3 


000000 


000000 


333 


L 000000 


000000 



This example shows the display from SHOW GROUPFLAGS. The first 
column is the group number with which the flags are associated. 
The second column is the access count. The two 6-digit numbers 
are the octal words that give the current state of each group 
global event flag. 

Group global event flags are flags 65 through 96. The first word 
starts at flag 80 and goes right to flag 65. The second word 
starts at flag 96 and goes right to flag 81. The final column is 
reserved for the delete flag DEL, which means the group global 
event flags are marked for delete and are not available. See 
Section 6.6.1. 
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The task is the fundamental executable programming unit. 

Tasks are built (linked) from one or more object modules. Tasks on 
RSX-11M/M-PLUS systems include tasks built from user programs as well 
as system tasks, such as compilers or utilities. 

Commands described in this chapter are used to initiate and terminate 
execution of tasks and to display the status of tasks. 



7.1 TASK INSTALLATION AND EXECUTION 

Tasks cannot execute unless they are installed in the system. The 
System Task Directory (STD) , a data structure in the Executive's 
dynamic storage region (pool), is the list of installed tasks. Each 
installed task is identified by a Task Control Block (TCB) in the STD. 
You can display the contents of the STD with SHOW TASKS/INSTALLED. 
See Section 7.12.5. 

Nonprivileged users can install their own tasks through the RUN 
command. These tasks remain installed as long as they are executing, 
and are removed from the system when they finish. Privileged users 
can install tasks. These tasks can also be caused to execute with the 
RUN command. The tasks remain installed after execution. 

Many system tasks can be caused to execute with other commands. For 
instance, EDIT/EDT causes EDT, the DEC Editor, to execute on your 
terminal, and LINK causes the Task Builder to execute. 

Installed tasks are not necessarily resident in memory or competing 
for system resources. Most installed tasks are dormant, meaning they 
are installed but have not been requested to run. A dormant task uses 
little memory, yet it is immediately available when it is needed, such 
as to service a real-time event. 

Installed tasks can be in either of two states: 

Dormant Installed but not requested to run 

Active Installed and requested to run 

Tasks remain active until they abort, exit, or terminate in some other 
way. During this time, they can be in one of two substates: 

Ready-to-run Competing for CPU time on the basis of priority 

Blocked Unable to compete for CPU time either because a 
needed resource is not available, or for 
synchronization purposes, or through the STOP/BLOCK 
command (Section 7.12.4). 
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You can display the list of active tasks with SHOW TASKS/ACTIVE. See 
Section 7.12.4. 

Tasks run at priorities of from 1 through 250, with 250 being the 
highest priority. The priority of a task can be established through 
the LINK, INSTALL, or RUN commands. Nonpr ivileged users are limited 
to priority 50 in the commands they issue, but if a privileged user 
has built or installed the task to run at a higher priority, then it 
will run at that priority for both privileged and nonprivileged users. 

Tasks can be built, installed, or run as checkpointable. 
Checkpointable tasks are liable to being checkpointed, or rolled out 
of memory to disks, in an incomplete state if a higher-priority task 
needs the memory space they are occupying. 

All memory is divided into partitions, which are subdivisions devoted 
to a particular task or tasks or to system functions. Partitions can 
be dedicated to a single task or shared by several tasks. If you do 
not specify a partition when you install and run a task, it will be 
installed in the default partition, named GEN. All partitions have a 
name and a size. 

Refer to the RSX-11M/M-PLUS Task Builder Manual for much more 
information on how tasks are built, installed, and run in partitions. 



7.1.1 Task Naming 

Tasks are installed under names from one through six Radix-50 
characters. The names identify the task in the STD. All commands and 
other operations affecting installed tasks require you to use the name 
of the installed task. 

Tasks acquire their installed names in a number of ways. 

Many task names include the number of the terminal from which the task 
was initiated. Terminal numbers are octal. Unless otherwise stated, 
all commands in examples in this section are assumed to have been 
issued from terminal TT10:. 

Tasks resulting from system commands are named after the command and 
the terminal from which the command was issued. Thus, the following 
command, issued from terminal TT10: 

>SH0W TIME 
results in a task named SHOT10 in the STD while the task is executing. 

Likewise, the following batch command, issued from virtual terminal 

VT4: 

$SHOW TIME 

results in a task named SH0V4 in the STD while the task is executing. 
Batch processing is available on RSX-11M-PLUS only. 

And, the following command, passed through DECnet by host terminal 
number 6: 

SHOW TIME 

results in a task name SH0H6 while the task is executing. (A host 
terminal is a DECnet virtual terminal.) 
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For tasks that are installed and run explicitly, task names can be 
established through the LINK command, the INSTALL command, and the RUN 
command . 

If you begin with a source file named ROBOT. MAC and use the default 
LINK command after assembling the object file, you will end up with a 
task image file named ROBOT. TSK. You can install this task image in 
two ways, through the privileged INSTALL command or through the 
nonprivileged RUN command. 

If you issue the privileged command 

>INSTALL ROBOT, TSK 
you will find the task name ROBOT in the STD. 
If you issue the command 

>RUN ROBOT. TSK 

you will find the task name TT10 in the STD while the task is 
executing. The installation is through the install-run-remove form of 
RUN, which assigns a task name based on the name of the terminal from 
which the command was issued. 

You can override these defaults at every step. 

The TASK= option of LINK permits you to specify the name under which 
you wish the task image file you are creating to be installed. If you 
thus specify the installed name of ROBOT1.TSK to be EANDO when you 
build the task, the privileged command 

>IN5TALL RGB0T1.TSK 
results in the task name EANDO in the STD. 
If, however, you issue the command 

>RUN ROBOT 1. TSK 

you will again find the task name TT10 in the STD while the task is 
executing, despite the specification of EANDO at task build time. 

The command 

>run/task_name: eando roboti .TSK 

results in the task name EANDO in the STD while the task is executing. 

Since the RUN command defaults to a task name that is based on the 
terminal designation (without the colon) , you must use the /TASK_NAME 
qualifier if you wish to use the RUN command to initiate execution of 
more than one task at a time from the same terminal. This is true 
because all task names in the STD are unique; you cannot have two 
tasks named TT10 installed at the same time, for example. See the 
examples in Section 7.2. 
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Finally, most DCL and MCR commands work by running tasks, although you 
do not have to issue a RUN command. The LINK command, for instance, 
runs the Task Builder. Such tasks are named after the first three 
letters of the command word, plus the terminal identifier. Thus, when 
you issue a command such as the following: 

>LINK RUMBLE 

the result is a task named LINT10. In fact, the RUN command itself 
results in the brief existence of a task named RUNT10. 

If you are running a utility, using a command in the form 

>MCR PIP 

your task will have a name of the form PIPT10. 

On RSX-11M systems only, there is a possibility of a slight variation 
in the task-naming rules. If, when you run a utility, you are the 
only user using that utility, the utility is installed under its 
prototype name, which has a name preceded by three dots, such as 
...PIP. Any subsequent users run the utility under a name in the form 
PIPT10. It makes no difference to you whether you are running the 
prototype or a copy. 

You never run the prototype on RSX-11M-PLUS systems. 

See Section 7.2 for more information on including the dollar-sign ($) 
i n a RUN command . 

On RSX-11M-PLUS systems with more than 64 terminals, tasks run from 
the higher-numbered terminals cannot be named directly after their 
terminals because of restrictions on the number of characters in a 
t-ask name. The following discussion describes the problem and its 
solution. .. ------ 

Remember that terminal numbers are octal. The first 64 terminals on 
an RSX-11M-PLUS system are numbered 1 through 77 (octal). The system 
supports as many as 256 terminals. Terminals 65 through 256 are 
numbered 100 through 377 (octal) i Tasks initiated from these 
terminals cannot be named directly after their terminals, because the 
task name is limited to six characters and their numbers, if used 
explicitly, are too large for task names. For example, SHOT107 is an 
illegal task name. 

Therefore, when the RUN command is issued from terminals numbered 100 
through 377 (octal), a slightly different derivation of task names is 
employed. Assume your terminal is TT107:. The command 

>RUN ROBOT '.'.', \ '"•''. .',',.;.■; ..:•;■'■'.'. -' 

initiates a task named TTA7. The letter A stands for the first two 
digits of the unit number of the terminal, 10 in this case. To 
minimize the confusion resulting from this convention, the display 
from SHOW TASKS/ACTIVE includes the name of the initiating teti«Injl in 
parentheses next to the name of the active :ask. The SHOW tar;;- itself 
will be named SHOTA7.. ■ • "'! . ■ <.;.:"'; ,.,,,."'■ ■"" ',„:,„ .:, 
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RUN 



The renumbering system replaces the first two digits of the unit 
number with a single letter. Here is a flu 1.1 list of the possible task 
numbers and the equivalent terminaJ unit numbers: 



Task Number 



Terminal Unit Number 



0-77 •- ,„yv. 

A0-A7 


■'',,,/::•'■ : : 0-77 »; 

:> '":■ ; - 100-107 


B0-B7 


, ' ■ ' ,110-117 


. C0-C7 ". : ■ 


■■'■>■■. r" , . - : 120-127 


D0-D7 *" 


- : : 130-137 


E0-E7 ;■ ■ ■ 


140-147 


F0-F7 


150-157 


G0-G7 


.. ' .' * : : 160-167 


HO -H'7 


■> " ■ 170-177 


10-17 ■' i.l': 


200-207 


JO -J 7 


? 1 - 7 1 7 


K0-K7 


• = ;■ - :■* ■'"'■ ;• 220-2 37 


L0-L7 


■ 230-23 7' 


M0-M7 ',,,.' : 


...V" "' ' : ;•- 240-247 


■ N0-K7 ■ '" " ^ -■ 


' --r"-"..\. ! ; 2 50 -25/ 


' O0-O7- 


.•260-267 


P0--P7 


270-277 


Q0-Q7 '"" 


'" -:. ■■'■''~'"3W~3-Q1: 


R0-R7 ■■ ■ • 


3.10-317 


so-s7 ": -".: 


'■"'..■ ■' ■ ■ 3(20-327 


T0-T7 • ■' , ■ 


. ' ■-- 330-337 


U0-U7 ,.,"" : 


: ,■,"'■" 340-347 


V0-V7 ■ ' " : ' 


'. ■ ■■ - -■ 3 5.0-3b7 


W0-W7 ' 


"■ '.-...■ •',::."'■" ■ 360-3 67 


X0-X7 


' : ■ ' » 3 70-377 



Only uninstalled tasks initiated with the RUN command have task names 
preceded by VT, TT, or HT. Tasks initiated by other DCL commands are 
named after the first three letters of the command that initiated the 
task, plus a T, V, or H (for physical, virtual, or DECnet host 
terminal) plus the unit number. 



7.2 INTRODUCTION TO THE RUN COMMAND 

RUN initiates the execution of a task. This command can be used in 
four ways: 

• To install, run, and remove upon execution a task from a task 
image file stored in a user's UFD. This is the most common 
use of the command. 

• To install, run, and remove after execution a task from a task 
image file stored in the system UFD, or library UFD an 
RSX-11M-PLUS systems. 

• To run immediately a task previously installed by a privileged 

user 

• To run at some future time, or according to a schedule, a task 
previously installed by a privileged user 

These functions are introduced in more detail in the following 
sections. 
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The first and most common use of RUN is to initiate execution of tasks 
contained in task image files. The command 

>RUN PUPPET. TSK 

directs the operating system to look in the default UFD on the default 
device for a task image file named PUPPET. TSK. When the file is 
found, the image is read in to memory and execution commences. When 
the task has executed, the image is removed from memory and from the 
STD. 

Whenever a RUN command includes any element of a file specification, 
this procedure is followed. The command 

>RUN DBOJHUPPET 

directs the operating system to look in the default directory on 
device DBO : for a file named MUPPET.TSK and install it, run it, and 
remove it when it has completed execution. The default file type in 
this case is .TSK, which is also the default file type for a task 
image file created by the Task Builder. 

The second use of RUN is to initiate execution of tasks contained in 
task image files in a system UP© (xm RSX-11M) , or the system -and 
library UFDs (on RSX-11M-PLUS) . The dollar sign ($) in a filespec 
indicates that you wish to use this form of RUN. The purpose of this 
convention is to relieve you of the necessity of knowing exactly where 
on the system various system tasks are stored. Simply include the $ 
in your RUN command and the system takes over. If you receive the 
error message 

RUN — File not found 

or 

INS — File not found 

your system manager has chosen not to include that particular task or 
utility in one of these UFDs, perhaps to conserve disk space. In this 
case, see your system manager. 

In general, you can use the $ to run most system tasks and utilities. 
These usually have three-letter names like PIP or TKB, but the RMS-11 
utilities have six-letter names like RMSDSP or RMSCNV. See the RMS-11 
documentation supplied with your system for more information on 
RMS-11. (Your system manager may also have added other task image 
files not supplied by DIGITAL to these directories for your 
convenience.) 

On RSX-11M systems, copies of many or all system tasks are placed in 
the system UFD on pseudo device LB:. The directory is usually [1,54], 
but it can be some other number. You can display the identity of this 
directory with the command SHOW SYSTEM/DIRECTORY. You can list the 
contents of the directory with a DIRECTORY command. 

On RSX-11M-PLUS systems, copies of many or all privileged system tasks 
are placed in the system UFD on pseudo device LB:. The directory is 
usually [1,54], but it can be some other number. You can display the 
,. ^„n».., „f ,-n,, ^n r , . . - , -h i-Vii* m""- > - RH W YSTEM " R E< I iRY. 
You can list the contents of the directory with a DIRECTORY command. 
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In addition, on RP>: llM-pr.us -systems, cor.-:.-.:; of many or al , 
nonpr ivileged system tasks are placed in the library UFD on pseudo 
device LB:. The directory is usually [3,54], but it can be some other 
number. You can display the identity of this airectory with the 
command SHOW LIBRARY/DIRECTORY. You can also list the contents of the 
directory with a DIRECTORY command. ..,,,, ,,„;.' 

The system responds to the $ in a filespec as follows. The command 

>RUN $TKB 

directs the operating system to look for a file called TKB.TSK and to 
install, run, and remove it when it has completed execution. Since 
the Task Builder is a privileged task, it will be found in the system 
UFD on either RSX-11M or RSX-11M-PLUS. The system installs, runs, and 
removes TKB just like any other task. 

On RSX-1.1M-PLUS, if the command had named a nonpriviloged task, such 

as in" the f o 1 1 o wi ng command : * ■■':■" -i : V,, ,„■,,„ '" ::i '; ; ,: '''. ' :. - ■ '.^.,.3,,,, "'' 

>run trip ■' "-\ ''■'" , ::.',, ;: "',-. .■■"■ ■ .- ■ ' '"'-i-'" ■'',;.,.'"' ':,::,;; 



the system would still start by searching the system UFD, but, failing 
to find PIP.T3K there, would have -?3ne on to the library UFD to search 
for PIP.TSK there. 



NOTE 

Privileged users can also use the dollar 
sign ($) with the INSTALL command. See 
Section 7.8. 

The third use of RUN is to execute immediately a previously installed 
task. The task must have been installed by a privileged user. The 
command 

>RUN TURTLi: 

directs the operating system to look in the list of installed tasks 
(STD) for a task named TURTLE. Once the system has found the task 
TURTLE in the STD, the task commences its execution. The task need 
not be installed since it is already installed, nor is it removed when 
it has completed its execution. The task runs under the name TURTLE, 
not TT10. 

(If the system does not find an installed task of the name you give, 
the command defaults to the install-run-remove form and looks in the 
default UFD on the default device for a file named TURTLE. TSK, and 
continues as described earlier.) 

Finally, privileged users can use RUN to schedule the execution of a 
task in several forms. Scheduling options include: 

• Run the installed task after so many hours, minutes, seconds, 
or ticks. 

• Run the installed task at an absolute time of day. 
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• Run the installed task in synchronization with the next hour, 
minute, second, or tick, that is, at the beginning of the next 
interval . 

• Run the installed task at regular intervals. 

In addition, these scheduling options can be combined. 

RUN as used to install, run, and remove tasks contained in task image 
files is described in Section 7.2.1. RUN as used with previously 
installed tasks is described in Section 7.2.2. 



7.2.1 Running Tasks Contained in Task Image Files 

When used to run an uninstalled task, RUN is actually a combination 
command, encompassing INSTALL, RUN, and REMOVE. This command is the 
only way a nonpr ivileged user can install or remove a task. 



Format 



RUN [/qualifier [s] ] 
Task? [$] f ilespec 

RUN[/qualifier[s] ] [$]filespec 

Command Qualifiers 

/[N03CHECKP0INT 
/COMMAND :"taskcommand" 
/[NO] POSTMORTEM 
/EXTENSION :n 
/PARTITION : pa rname 
/PRIORITY :n 
/STATUS: a rg 

TASK 

COMMAND 
/TASK_NAME : taskname 
/TIME_LIMIT:n[u] 
/UIC: [g,m] 

Parameter 

[$] f ilespec 

Specifies a task image file on a mounted Files-11 volume. This 
task is installed, run, and then removed when it has finished 
executing. 

The default file type is .TSK. See Notes. 

The dollar sign ($) directs the system to search first for the 
file in the system UFD and, on RSX-11M-PLUS systems, also in the 
library UFD. In this case, the $ specifies a device and 
directory and thus counts as an element of a file specification. 

Command Qualifiers 

These qualifiers establish how the uninstalled task is to be 
installed. 
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/[NO] CHECKPOINT 

Specifies whether or not the task is to be run checkpointable. 
The default is established when the task is built (linked) . This 
qualifier is used to override the default. 

In other words, this qualifier allows you to run checkpointable 
tasks as noncheckpointable and vice versa. 

/COMMAND:" taskcommand" 

Use the /COMMAND qualifier to pass a command to the task you are 
running. The command must be inside the "quotes" and not more 
than 40 characters long. For example, the command 

>RUN/COMMAND:"/LI" $PIP 

runs PIP and then passes the /LI switch to it. This results in a 
directory listing. 

/[NO] POSTMORTEM 

Specifies whether or not a Postmortem Dump is to be generated if 
the task terminates unexpectedly. 

The default is determined when the task is built. If not 
specified, the LINK command defaults to /NOPOSTMORTEM. See the 
RSX-11M/M-PLUS Task Builder Manual for more information on 
Postmortem Dumps. 

/EXTENSION :n 

Specifies that n additional decimal words of address space be 
allocated to a task. 

/PARTITION :parname 

Specifies the partition in which the task is to run. The default 
is established when the task is built (linked). This qualifier 
is used to override the default. 

If no partition is established at task build or with the RUN 
command, the task will run in the default partition GEN. 

/PRIORITY:n 

Specifies at what priority the task is to run. This is a 

privileged qualifier. The default is established when the task 

is built (linked). This qualifier is used to override the 
default. 

The default priority for the Task Builder, INSTALL, and RUN is 50 
(decimal) . If a task has been built or installed at another 
priority, nonprivileged users can run it at that priority. 
Otherwise, nonprivileged users are limited to running tasks at 
the default priority. 

Priorities range from 1 through 250 (decimal) . 
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/STATUS: a rg 
TASK 
COMMAND 

Specifies whether exit status is to be returned from the RUN 
command or from the task being run with the RUN command. The 
default is /STATUS: COMMAND and need not be specified. 

The /STATUS:TASK qualifier may be necessary in user batch jobs 
that run installed tasks where the batch processor must wait for 
the installed task to exit before attempting to execute the next 
command. 

/TASK_NAME : taskname 

Specifies the name under which the task is to be run. The 
default is to run the task under a name derived from the name of 
the terminal from which the RUN command was issued, as discussed 
in Section 7.1.1. 

Use this qualifier when you wish to run two tasks simultaneously 
using the RUN command. Otherwise, the second RUN command causes 
the following error message to appear on your terminal: 

RUN — Task name already in use 

See the examples. 

Task names are restricted to six Radix-50 characters. The 
Radix-50 character set consists of the 26 uppercase letters, the 
10 numerals, and the period {.) and dollar sign ($) . 

/TIME_LIMIT:n[u] 

This RSX-11M-PLUS qualifier allows you to limit the amount of CPU 
time the task can run. The default is /TIME_LIMIT: 3M. The "M" 
stands for minutes. If you give simply a number as an argument, 
the time unit defaults to minutes, but you can also specify a 
time limit in seconds by using a number and an "S", as in 
/TIME_LIMIT:30S. 

/UIC:[g,m] 

Specifies the default UIC for the task. This is a privileged 
qualifier. This UIC determines in what protection class the task 
belongs, and thus determines file access. 

The square brackets are required syntax. 

Examples 

>RUN 

Task? ROBOT 

This example installs, runs, and removes upon completion of 
execution the task contained in the task image file named 
ROBOT. TSK from the default UFD on the default device. 
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>RUN ROBOT 

>RUN ROBOT, TSK 

The two commands in this example are the equivalent of the 
command in the previous example. 

The following examples illustrate the task-naming convention. 
See Section 7.1.1 for more information on task naming. 

On RSX-1JW systems, the terminal number in parentheses is not 
displayed. "V" ; . ; '",„;; V .,,;„. ; ■ ■.■;:,,/'''.„, ' : "'" ; ■ ' : ' : ' : '- 

On RSX-11M-PLUS systems, the terminal number in parentheses 
indicates the terminal from which the tasks arc being run, In 
this example, the terminal number Is lower than 77 {octal* . See 

the next example. : ■■■ L ; ■■ ' : .•■'-■■■ - ■ '- ■' ., ••"""*■ ■ 



-■ >RUN R0I-:OV. .,, ■ . , /". ■ .„',,' . ' . .. . ,'.',:;'.' 

; i, ;; : ">s h 6«, ^wm'/^cfLij E""; ■ ; ■ r """"'' ! ,:: '"'~ :.:[■'■:■■ '' '..:.. "■""'. ':;-■; ""■'■"", . "": ; " ■ ■ i; "- : "v;, ,"".- ':■•' ! :: : " t: £• -i " : "; : ;~ 

i..' MCR. . , ;' "f -^ ..,.""' ' ', 1 iC/' J I '"""".' : '■ '..I".;"""' ^ ■'" : -~, :% : -":' .I':,,."""' ■'. V *■■■;■.. "~..J.''' ^ 

• . . - b v H0T-A7 " ' : • ■ ' <.r VI 0? 5 >'.':;■'' ■' - ' " ' ' "'' : " ' ■' ' ' " ■■.'". ' ' " : ' " 

' : TTA7 ■ ■ ;. ' (niO/'i ) ■ " " • " , " ' - •'"..'. 

This example is tor RSX-11M-PLUR only and illustrates the: 
task-naming convention as applied f:rom a terminal with a unit 
number greater tr.an 77 (octal). In this case. TT107:. Notice the 
name given to the SHOW task'. ■■■■■:■■■ ":"".. '■■-■. , *?":,.. ■■'■■'"■*"■■■■::,.. ■ ■ 



>run/task_nameh:apek roboi 
>sh0w tasks/active 

MCR, . , (T'l 10 > , 

SH0T10 <TT 10; • 

CAPEK <TTiO) > 

This example shows how the task-naming convention can be 
overridden for the RUN command by running the task under another 
name using the /TASK_NAME qualifier. 

>RUN ROBOT 

>SH0W TASKS/ACTIVE 

MCR, . , iino; ) 

SH0T10 (TTIOM 

TT10 CTT'O' • 

>RUN AS I MOV 

RUN -- Task name already in use 

>RUN/T ask: BINDER AS I MOV 

>SH0W TASKS/ACTIVE 

MCR... (TTlOt) 

SHOT 10 : ■ m-;.. • 

T T 1 u < T 7 l : « 

BINDER (TTIOJ) 

This example shows how you can run two tasks simultaneously using 
the RUN command and the /TASK NAME qualifier. 
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Notes 



The return of the implicit monitor prompt (>) signifies that the 
task initiated by the RUN command has exited. However, you need 
not wait for the prompt to return to issue another command. 
Simply enter a carriage return or CTRL/C and enter the command. 

This section describes RUN as it works with any portion of a file 
specification included. In general, you do not have to include 
the file type, as .TSK is the default. In one unusual 
circumstance, however, you must explicitly enter a file type. If 
there is a task already installed in the system that has the same 
task name as the file name of the task image file containing the 
task you wish to run, the RUN command will run the installed task 
rather than the one you wish to run. In such an instance, you 
must include the file type to force the RUN command to access the 
task image file. 

Some error messages resulting from RUN are labeled INS rather 
than RUN because this form of RUN installs the task automatically 
and the error occurs during the installation. 



7.2.2 Running and Scheduling Installed Tasks 

RUN also initiates the execution of installed tasks. Privileged users 
can use RUN to initiate the execution of installed tasks on a schedule 
by creating entries in the system clock queue. 

Tasks that run as a result of entries in the clock queue run with 
pseudo device COO: as their TI:. For this reason, these commands are 
privileged. Such tasks send output to COO: and not to the terminal 
they were run from. 

Format 

RUN[/qualifier[sJ ] 
Task? taskname 

RUN[/qualif ier [s] ] taskname 

Command Qualifiers 

/DELAY: nu 
/INTERVAL :nu 
/SCHEDULE : hh : mm : ss 
/STATUS: COMMAND 

TASK 
/SYNCHRONIZED 
/UIC:[g,m] 

Parameter 

taskname 

Specifies the name of the installed task to be run. The names of 
installed tasks are one through six Radix-50 characters. 
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If the System Task Directory (STD) contains no entry under the 
task name you supply, the system searches the default directory 
on the default device for a file named taskname.TSK. If RUN 
finds such a file, it installs, runs, and removes it. 

Command Qualifiers 

The time-oriented qualifiers to RUN create entries in the system 
clock queue. The contents of the clock queue can be displayed 
with the command SHOW CLOCK_QUEUE. See Section 7.12.9. 

/DELAY :nu 

Specifies that the task be run after the stated amount of time 
passes. This qualifier is privileged. The argument nu specifies 
the amount of the delay as a number of units, n is the number of 
units and u is the time unit as follows: 

T - Ticks 
S - Seconds 
M - Minutes 
H - Hours 

If your system has the standard line-frequency clock, the length 
of a tick depends on the line frequency of the electric power 
source serving your location. Most commonly, this frequency is 
60 Hz, which results in a tick length of l/60th of a second. 

If your system has an optional programmable clock, the length of 
a tick depends on the choice made at system-generation time. See 
your system manager for more information. 

Acceptable values for these units are as follows: 

T - Any positive value to a maximum of 15 bits, or 32767. 

S - Any positive value to a maximum of 15 bits, or 32767. 

M - The maximum value is 1440. 

H - The maximum value is 24. 

The system always waits at least one interval. If you specify 0, 
the system treats it as a 1. 

/INTERVAL :nu 

Specifies that the task is to be run at regular intervals. This 
qualifier is privileged. The argument nu specifies the interval 
as a number of units of time, n is the number of units, and u is 
the unit as follows: 

T - Ticks 
S - Seconds 
M - Minutes 
H - Hours 

See the /DELAY qualifier for a detailed description of these 
units. 
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/SCHEDULE:hh :mm:ss 

Specifies that the task be run at a particular time of day. This 
is a privileged qualifier. 

/STATUS: a rg 

COMMAND 
TASK 

Specifies whether exit status is to be returned from the RUN 
command or from the installed task being run with the RUN 
command. This is not a privileged qualifier. The default is 
/STATUS: COMMAND and need not be specified. 

The /STATUS:TASK qualifier may be necessary in user batch jobs 
that run installed tasks where the batch processor must wait for 
the installed task to exit before attempting to execute the next 
command. See the examples using /STATUS:TASK. 

/SYNCHRONIZED 

Specifies that the execution of the task be synchronized on the 
next occurrence of a particular clock unit. This is a privileged 
qualifier, u is the time unit as follows: 

T - Ticks 
S - Seconds 
M - Minutes 
H - Hours 

See the /DELAY qualifier for a detailed description of these 
units. 

/UIC:[g,m] 

Specifies the default UIC for the task. This is a privileged 
qualifier. The task's UIC determines what file-protection class 
it belongs in, and thus directly influences file access. 

The square brackets are required syntax. 

Examples 

>RUN/DELAYi5S PINBAL 

This example initiates execution of the installed task PINBAL 
five seconds after the command is entered. 



>RUN/INTERVALJ20M wizard 

This example initiates execution of the installed task WIZARD 
immediately and every 20 minutes thereafter. 



> RUN/DELAY {10M/ INTER VALtlH TOMMY 

This example initiates execution of the installed task TOMMY 
after ten minutes and every hour thereafter. 
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>RUN/SCHEDUL£ X 1 2 X 00 *. 00 NOON 

This example initiates execution of the installed task NOON at 
the next 12:00:00 after the command is entered. If you entered 
the command before noon today, NOON would run at noon today. If 
you entered the command after noon today, NOON would run at noon 
tomorrow. 



>run/synchronize:h bogus 

This example initiates execution of the installed task named 
BOGUS on the next hour. If you entered the command at 9:15, 
BOGUS would begin running at 10:00:00. 

> RUN/SYNCHRON 1 2ESH/ 1NTERUAU 1H BEL.T0L 

This example initiates execution of the installed task named 
BELTOL every hour on the hour, starting with the next hour. 



$INSTALL $HIFI 
$RUN/STATUS:TASK HIFI 
$EOJ 

This example illustrates the use of the /STATUS:TASK qualifier in 
a user batch job. First the job installs the task HIFI from the 
library UFD. Then the task is run. If the user had not 
included the /STATUS:TASK qualifier, the RUN command would have 
returned a status of success, the batch processor would have 
executed the EOJ, and the EOJ would have aborted the task that 
had just started running. With the qualifier, the EOJ is not 
executed until after the task has exited. See next example. 



$INSTALL CAVIAR 

$RUN/STATUS:TASK CAVIAR 

$PRINT/FLAG PAGE FISHEGGS. LST, SHADROE.LST 



This example also illust 
qualifier in a user batch 
CAVIAR. When run, this 
FISHEGGS. LST and SHADROE. 
written and closed, the bat 
/STATUS:TASK qualifier on 
waits for the installed tas 
print the files. Withou 
would attempt to print the 
written. 



rates the use of the /STATUS: TASK 
job. First the job installs the task 
task writes two listing files, 
LST. After these files have been 
ch job prints them both. With the 
the RUN command, the batch processor 
k CAVIAR to exit before attempting to 
t the qualifier, the batch processor 
files while they were still being 
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Notes 

The implicit prompt returns immediately after you issue a RUN 
command for an installed task and does not indicate that the task 
has completed its execution. 

You can display entries in the clock queue with SHOW CLOCK_QUEUE, 
Section 7.12.9. 

The clock queue is kept in pool and must be restored whenever the 
system is rebooted. 

Error Message 

RUN — Invalid time parameter 

Explanation: Command specified an invalid time argument. 
User Action: Check for proper syntax and reenter command. 



7 . 3 ABORT 

ABORT forces an orderly end to a running task or to the action of a 
specific command. 

Tasks can also be aborted by other tasks or by error-handling 
routines. If this happens, some of the messages discussed below can 
appear on your terminal without your having issued an ABORT command. 

Nonprivileged users can abort any task running on TI:. Privileged 
users can abort any task. 

Format 

ABORT [/COMMAND] [/qual i f ier [ s] ] commandname 

ABORT/TASK [/quali f ier [ s] ] [taskname] 

Command Qualifiers 

/COMMAND 
/TASK 

/TERMINAL :ttnn: 
/[NO] POSTMORTEM 

Parameters 

The parameters differ depending on whether you are aborting a 
command or a task. 

The default is to abort a command. See the examples. 

commandname 

Specifies the command whose effect you wish to cancel. This 
parameter can be used only when the /TASK qualifier is not 
present. You must specify at least the first three characters of 
the command verb. 
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taskname 

Specifies the name of the task you wish to abort. This parameter 
requires the presence of the /TASK qualifier. If you use the 
/TASK qualifier and do not specify a task name, you will get an 
error message, "Illegal task name." 

Command Qualifiers 

/COMMAND 

Specifies that you wish to abort a command. This is the default 
qualifier and need not be included. 

/TASK 

Specifies that you wish to abort a task by name. 

/TERMINAL :ddnn: 

Specifies that a task from some terminal other than your own be 
aborted. This is a privileged qualifier for RSX-11M-PLUS only. 

/[NO] POSTMORTEM 

Specifies that a Postmortem Dump be taken (or not taken) of the 
task before it is aborted. See the RSX-11M/M-PLUS Task Builder 
Manual for more information. 

If the task is memory-resident, the contents of its registers are 
listed on the terminal. If it is checkpointed, no register 
contents are listed. 

You can specify a Postmortem Dump when you build a task or when 
you install it (including install-run-remove) . The default for 
this qualifier is determined by previous specification of the 
/DUMP qualifier. If no /POSTMORTEM qualifier has been specified, 
the default is /NOPOSTMORTEM. 

Examples 

>ABO RUN 

llJllJll Task "TT10* terminated 

Aborted vis directive OR CL'I 

This example aborts a task initiated with the RUN command running 
on your terminal. See next example. 

>RUN TREK 

orders; star date = 2000 

you hust destroy the klingon invasion forces of 29 battle 

cruisers. you have 40 solar years to complete your mission,, 

READY? Etrlc; 

DCL>AB0RT RUN 

12n.H09 Task ■TTIO' terminated 

Aborted vi3 directive or CLI 

In this example, the user installed the interactive task TREK by 
means of a RUN command. Then, instead of providing the task with 
requested input, the user issued a CTRL/C to return to the DCL 
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monitor level and then issued the ABORT command. DCL prompted 
for the command to be aborted and RUN was specified. The task 
was aborted and removed, and the message displayed. The message 
mentions MCR because DCL does not actually perform the abort. 



> ABORT /TASK MACO 

This example aborts the task named MACT3. Nonprivileged users 
can abort tasks running on their own terminals. Privileged users 
can abort tasks by name running on any terminal. See next 
example. 



^DIRECTORY *.RN0 



Directory DB2 t C303 i 53 
20-N0U- 32 16J 28 

ALTCLI,RN0?3 213. 27-AUG-82 16:52 

ANNI.RNQ56 3, 30-JUL-82 09:30 

APRCOM.RNOM 9, l.S-APR-82 10! 35 

BEST,RN0?5 40. 28--AUG--82 15J30 

CATCH. RHQiA 7. 22--MAY-82 09:39 

CHAP11SMG.RN0J13 49, 13-0CT-82 16fS6 

CHAP12SMG.RN0J51 223. 08-0CT-S2 13H5 

CHARSET.RNOfS 6. 15-JUN-82 li:57@|Dc) 

DCL> ABORT DIRECTORY 
16*.29M5 Task "DIRT56" terminated 

Aborted via directive or CL.I 

In this example, the user issued a DIRECTORY command and soon saw 
that the file he was checking for was present. Rather than wait 
for the directory listing to complete, the user typed CTRL/C and 
entered the ABORT command in response to the explicit DCL prompt. 
The ABORT command defaults to ABORT/COMMAND. 

^•ABORT/TERMINAL ITT3J MACRO 

This example, issued by a privileged user, aborts the MACRO task 
running on another terminal. Notification of the abort appears 
on TT3: but not on the terminal from which the ABORT command was 
issued. RSX-11M-PLUS only. 

>AB0RT/DUMP RUN 

14:41:11 Task "TT10 * terminated 

Aborted via directive or CLI 

R0=000000 

Rl= 100077 

R2=135600 

R3=000000 

R4--000000 

R5=000000 

SP=0l2540 

PS=170017 



In this example, the user requested a Postmortem Dump. The 
contents of the task's registers at the time of the abort are 
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listed on the terminal along with notification of the dump. The 
dump file will be printed on the system's line printer. 

Notes 

A is the short form of ABORT. 

ABORT forces an orderly termination of a task. To effect the 
termination, the system performs four steps: 

• Alters the task's priority to 247. A task must be memory 
resident to be aborted. This step usually forces the 
quick return of a checkpointed task. 

• Performs I/O rundown: cancels I/O for nonf ile-structured 
devices; completes I/O for file-structured devices and 
deaccesses files; detaches all attached devices. 

• Executes the Task Termination Notification program 
(TKTN) , which displays messages on the aborted task's 
TI:. 

• Releases any memory allocated to the task if the task is 
not fixed. 

The TKTN routine can list a number of messages about the abort. 
These messages are explained below. 

LOGOUT also aborts nonprivileged tasks running from your 
terminal. 

Tasks can also be aborted by Executive directives issued by other 
tasks, in particular, by error-handling routines. 

TKTN Messages 

These messages appear as part of the notification of the abort. 
Often a list of register contents also is displayed. 
Understanding these messages requires an understanding of how the 
PDP-11 executes instructions. If you receive these messages and 
do not understand them, you should copy them, along with any 
other terminal output, and show them to your system manager. 

Aborted via directive or CLI 

Explanation: Either a CLI or an Executive directive issued by 
another task caused the task to be aborted. 

AST abort. Bad stack 

Explanation: An AST could not be effected because the AST 
parameters could not be pushed on the stack. 

Checkpoint failure. Read error 

Explanation: The task could not be read back into memory after 
being checkpointed. 
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IOT execution 

Explanation: The task executed an IOT instruction, and no SST 
routine was specified to process the trap. 

Load failure. Read error 

Explanation: The task could not be loaded because of a hardware 
error. 

Memory protect violation 

Explanation: The task encountered a memory-protect violation and 
no SST routine was specified to process the trap. 

Non RSX EMT execution 

Explanation: The task executed an EMT instruction with an 
argument other than 377 (octal) or, in the case of a privileged 
task switching to system state, 376 (octal) , and no SST routine 
was specified to process the trap. 

Odd address or other trap four 

Explanation: The task executed a word instruction with an odd 
address, or it referenced a nonexistent memory location, and no 
SST routine was specified to process the trap. 

Parity error 

Explanation: A parity error occurred while the task was 
executing. The task was fixed in memory so that the memory could 
not be reused by another task. 

Reserved INST instruction 

Explanation: The task executed an illegal instruction, and no 
SST routine was specified to process the trap. 

SST abort. Bad stack 

Explanation: An SST could not be effected because the SST 
parameters could not be pushed onto the task's stack. 

Task exit with outstanding 10 

Explanation: The task exited with one or more outstanding I/O 
requests. Tasks should terminate all I/O operations before 
exiting. The system does, however, clean up all outstanding I/O. 

T bit trap or BPT instruction 

Explanation: The task either set the T bit in the Processor 
Status Word or executed a BPT instruction, and no SST routine was 
specified to process the trap. 

Trap execution 

Explanation: The task executed a Trap instruction, and no SST 
routine was specified to process the trap. 
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Error Messages 

ABO — Task marked for abort 

Explanation: A previous command requested that the task be 
aborted, but the abort has not yet completed. This may mean the 
task marked for abort is not currently resident in memory. 

User Action: None. 

ABO — Task not active 

Explanation: The specified task is not currently active. 

User Action: Check command for proper task name and reenter it. 

7.4 CONTINUE 

CONTINUE resumes execution of a previously suspended task. 

Nonprivileged users can continue tasks initiated from their own 
terminals. Privileged users can continue any suspended task. 

Format 

CONTINUE [/TERMINAL :ddnn:] [taskname] 

Command Qualifier 

/TERMINAL:ddnn: 
Parameter 

If you do not supply a parameter, the task running at your 
terminal initiated by the RUN command is continued. 

Tasks are suspended through the execution of a SPND$S directive 
within the task. A RSUM$ directive is another way of continuing 
a suspended task. 

taskname 

Specifies the suspended task you wish to continue. If you do not 
specify a task name, the default is a task named after the 
terminal . 

Command Qualifier 

/TERMINAL:ddnn: 

Allows you to continue a suspended task running on some other 
terminal. This is a privileged qualifier for RSX-11M-PLUS only. 
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Example 

>RUN YOYO 



"Message from Yoyo: Yoyo is suspended" 
>SH0W TASK/ACTIVE T^iO 

tt10 070530 gen 00677100-00701600 f'ri - 50. dpri - 50, 
status; -chk spn -pmd rem mcr 
ti - tt105 ioc - 0. eflg 000001 000000 ps 170000 pc 001254 

REGS 0-6 001372 000037 000012 140311 001254 

>C0NTINUE 

"Message from Yoyo? Not suspended. Climbing string" 

In this example, the user ran a task that issues a message and 
then suspends itself. Not all suspended tasks issue such 
messages, but you can identify a suspended task through SHOW 
TASKS/ACTIVE. ' The user issued SHOW TASKS/ACTIVE and named the 
task. Included in the listing under STATUS on the second line 
the mnemonic SPN verifies that the task was suspended. The user 
issued CONTINUE without naming the task. Since the task was 
initiated by RUN, CONTINUE defaulted to a task name based on the 
name of the terminal. 

Notes 

A task cannot suspend any task other than itself. 

For more information on task states, see the RSX-11M/M-PLUS 
Executive Reference Manual . 

Batch jobs may include the noninteractive form of CONTINUE as a 
no-operation command. See the RSX-11M-PLUS Batch and Queue 
Operations Manual for more information. 

Error Message 

CON — Task not suspended 

Explanation: Command attempted to continue an unsuspended task. 
User Action: None. 



7 . 5 CANCEL 

CANCEL eliminates entries from the clock queue. Entries are placed in 
the clock queue through the RUN$ directive or from the privileged 
time- based forms of the RUN command. 

Nonprivileged users can only cancel entries from a task initiated from 
the entering terminal. Privileged users can cancel any clock queue 
entries . 

CANCEL does not affect a currently executing task, but only the 
pending entries in the clock queue. 
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Format 

CANCEL 

Task? taskname 

CANCEL taskname 

Parameter 

taskname 

Specifies the name of the installed task whose clock-queue 
entries you wish to eliminate. 



Example 



>run/belay:5m arbvrk 
>sh0w clock-queue 

ARDVRK Scheduled at, 17-JUL-82 10J44J31J09 
>CANCEL ARDVRK 
>SHOW CLOCK-QUEUE 



In this example, the user issued a command to run the installed 
task ARDVRK at exactly five minutes from when the command was 
entered. The user verified that ARDVRK was in the clock queue 
(as the only entry) . Then the user issued the CANCEL command to 
eliminate the scheduled run of ARDVRK. The user issued a second 
SHOW CLOCK_QUEUE to verify that the scheduled entry was cleared. 
If ARDVRK had been running at the time, the CANCEL would have had 
no effect. 



Notes 



See Section 7.12.9 for information on SHOW CLOCK QUEUE. 



7.6 STOP/BLOCK 

STOP/BLOCK blocks an installed running task. The task no longer 
executes or competes for memory. Nonprivileged users can block tasks 
running from their own terminals. Privileged users can block any 
task. 



Format 



STOP/BLOCK [/qualifier] [taskname] 
Command Qualifier 
/TERMINAL :ttnn: 



Parameter 

taskname 



Names the task to be blocked. If you do not name a task, the 
task initiated with the RUN command and named after the terminal 
is blocked. 
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Command Qualifier 

/TERMINAL :ttnn: 

This is a privileged qualifier for RSX-11M-PLUS only. Specifies 
that a task running from the named terminal is to be blocked. 

Example 

>run advent 
>sho task/active: 

MCR * * * 

SHOTS 

TT5 

>STQP/BLOCK 

>SH0W TASKJTT5/FULL 

TT5 100604 GEN 073464 00541000-005436 PRI - 50. DPR I - 

50. 

STATUS*. BLK -CHK WFR -PhD REM MCR 

TI - TT5S IOC - 0. BIO - 0. EFLG - 000001 000000 PS - 170000 

PC - 002206 REGS 0-6 001637 040066 040060 140311 163500 000000 001252 

S' 

•-. 
s 

>START/UNBLOCK 
>SH0U TASKtTTS/FULL 

TTS 100604 GEN 073464 00541000-005436 PRI - 50. DPRI - jO . 
STATUS t -CHK WFR *PMD REM MCR 

TI - TT5! IOC - 1. BIO - 0. EFLG - 000001 000000 PS - 170000 
PC - 002206 REGS 0-6 006173 042066 040060 140311 163500 000000 001260 
> 

In this example, the user on terminal TT5: ran a task with the 
RUN command, giving the task the name TT5 by default. The user 
then issued the STOP/BLOCK command, without naming the task. The 
/FULL display from SHOW TASKS shows task TT5 ' s status as blocked 
(BLK flag) . Then the user issued the START/UNBLOCK command and 
checked the status again. This time, the BLK flag is not 
present. 



Notes 



The START/UNBLOCK and ABORT commands are the only means of 
canceling the STOP/BLOCK command. 

A blocked task has an effective priority of 0. If it is 
checkpointable, any task can checkpoint it. Once checkpointed, 
the blocked task stays checkpointed because it is ineligible to 
compete for memory. A blocked, checkpointed task is unblocked 
when it is aborted. 

A task can also be blocked by the system while waiting for some 
needed resource or for synchronization purposes. 

There are no prompts from this command. 

See Section 7.12.3 for an explanation of the task status flags. 

There are several STOP/function commands associated with the 
Queue Manager. See the RSX-11M/M-PLUS System Management Guide . 
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7 . 7 START 

The START command resumes execution of a task that was stopped by the 
STOP$S directive. Note that starting a stopped task is different from 
continuing a suspended one. 

Format 

START [/TERMINAL:ddnn:l [taskname] 

Parameter 

taskname 

Specifies the name of the task you wish to start. If you do not 
specify a taskname, the task running at your terminal that was 
initiated by the RUN command is started, that is, a task named 
after your terminal. 

Command Qualifier 

/TERMINAL:ttnn: 

The /TERMINAL qualifier allows a privileged user to start a 
stopped task that is running on some other terminal. 



Notes 



Several other forms of the start command are used to control the 
Queue Manager. See the RSX-11M/M-PLUS Batch and Queue Operations 
Manual and the RSX-11M/MPLUS System Management Guide for more 
information. 



7.7.1 START/UNBLOCK 

START/UNBLOCK continues the execution of a task blocked by the 
STOP/BLOCK command. Nonpr ivileged users can unblock any task running 
from their own terminal. Privileged users can unblock any task. 

Format 

START/UNBLOCK [/qualifier] [taskname] 

Command Qualifier 

/TERMINAL: ttnn: 

Parameter 

taskname 

Names the task to be unblocked. If you do not name a task, the 
task initiated with the RUN command and named after the terminal 
is unblocked, if blocked. 
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Command Qualifier 

/TERMINAL :ttnn: 

This is a privileged qualifier for RSX-11M-PLUS only. Specifies 
that a task running from the named terminal is to be unblocked. 

Notes 

See the description of STOP/BLOCK for an example. 

START/UNBLOCK does not unblock tasks blocked by the Executive 
while waiting for system resources or for synchronization. You 
can only unblock tasks blocked with the STOP/BLOCK command. 

The START/UNBLOCK and ABORT commands are the only means of 
canceling the STOP/BLOCK command. 

The system automatically unblocks a blocked task when the blocked 
task is aborted. 



7.8 INSTALL 

INSTALL includes a specific task in the System Task Directory, thus 
making it known to the system. 

An installed task is dormant until it is requested to run by the 
Executive. You can request an installed task to run through the RUN 
command or through a variety of Executive directives, including RQST$ 
(Request) , RUN$ (Run) , and SPWN$ (Spawn) . 

This is a privileged command. Nonprivileged users install tasks 
temporarily through RUN, which includes most of the same qualifiers as 
INSTALL. See Section 7.2. 



Format 



INSTALL [/qual if ier[s] ] 
File(s)? [$]filespec 

INSTALL[/qualifier[s] ] [$] filespec 

Command Qualifiers 

/[NO] CHECKPOINT 

/COMMAND : " taskcommand" 

/[NO] POSTMORTEM 

/EXTENSIONS 

/MULTIUSER_PARTITION:parname 

/PARITITION: par name 

/PRIORITY :n 

/READONLY_COMMON 

/[NO] SLAVE 

/TASK_NAME:taskname 

/UIC: [g,m] 
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Parameter 

[$] filespec 

Specifies the name of the task image file containing the task you 
wish to install. .TSK is the default file type. The dollar sign 
($), if present, directs the system to search for the file in the 
system UFD and, on RSX-11M-PLUS systems, in the librae/ LiFD. If 
you do not include the /TASK_NAME qualifier, the task will be 
installed under a name based on the first six characters of the 
file name unless another name was assigned through the TASK= 
option of the Task Builder. See examples. 

Command Qualifiers 

/[NO] CHECKPOINT 

Specifies whether or not the task is to be checkpointable. The 
default is set at link time. This qualifier overrides the 
link-time checkpointability specification. 

/COMMAND : " taskcommand" 

Use the /COMMAND qualifier to pass a command to the task you are 
installing. The command must be inside the "quotes" and not more 
than 40 characters long. For example, the command 

MNSTALL/COMMAND:" /LI" $PIP 

installs PIP and then passes the /LI switch to it. This results 
in a directory listing. 

/[NO] POSTMORTEM 

Specifies whether or not a Postmortem Dump (PMD) is to be 
generated if the task aborts because of an SST error condition. 
The default is set at link time. This qualifier overrides the 
link-time specification. See the RSX-11M/M-PLUS Task Builder 
Manual for further information. 

/EXTENSION :n 

Specifies that n (octal) additional words of address space are to 
be allocated to a task. 

/MULTIUSER_PARTITION:parname 

Specifies the partition into which the read-only portion of a 
multiuser task is to be installed. 

/PARTITION rparname 

Specifies the partition into which the task is to be installed. 
The default is set at link time. This qualifier overrides the 
link-time specification. 

If you name a partition that does not exist, you receive a 
warning message and the system attempts to install the task in 
the default partition GEN. 
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/PRIORITY:n 

Specifies the priority at which the task is to run. The default 
is set at link time. This qualifier overrides the default set at 
link-time, n can be from through 250. 

/READONLY_COMMON 

Specifies that a common region is to be installed as a read-only 
common. 

/[NO] SLAVE 

Specifies whether or not the task is to be slaved. 

Data sent to a slaved task is marked with the TI: of the sending 

task. When the installed task receives the data, the system sets 

the task's TI: to that associated with the data. The default is 

set at link time. This qualifier overrides the link-time 
specification. 

Note that data may not be sent to a slaved task running on a 
virtual terminal. 

/TASK_NAME:taskname 

Specifies the name by which the task is to be referenced. The 
default is set at link time. This qualifier overrides the 
link-time specification. See examples, 

/UIC: [g,m] 

Specifies the default UIC for the task. This task UIC determines 
in what protection class the task belongs and thus directly 
influences file access. 

The brackets are required syntax. 



P v amnl ■ 



>INSTALL FATE 

This example looks for a task image file named FATE.TSK on the 
default device and in the default UFD and installs it as FATE in 
the STD, assuming no other name was specified at link time. 



>INSTALL *LATE 

This example looks in the system UFD (by convention, [1,54]) and, 
on RSX-11M-PLUS systems, the library UFD (by convention, [3,54]) 
for a task image file named LATE.TSK and installs it as LATE in 
the STD, assuming no other name was specified at link time. 



>INSTALL bucking 

This example looks for a task image file named BUCKING. TSK on the 
default device and in the default UFD, and installs it as BUCKIN 
in the STD, assuming no other name was specified at link time. 



7-28 



RUNNING TASKS 



INSTALL (Cont.) 



>install/task:dggr gate 

This example looks on the default device in the default UFD for a 
task image file named GATE.TSK and installs it as DOOR in the 
STD, overriding any task name specified at link time. 

> INST ALL/PART IT I ONJLEROY KILROY 

This example installs the task image file named KILROY. TSK in a 
partition named LEROY. 

> I NSTALL/CHECKPO I NT/ POSTMORTEM/PR I OR I TY;?5/TftSK: LARGO KEY 

This example looks for a task image file named KEY. TSK in the 
default location and installs it in the STD under the name LARGO. 
The task is installed as checkpointable and at a priority of 75 
(decimal) . If the task should exit unexpectedly, a Postmortem 
Dump is generated. 

Notes 

REMOVE counteracts INSTALL. See Section 7.9. 

Tasks can also be installed through the install-run-remove form 
of the RUN command. Such tasks remain installed only while they 
are executing. 

While such tasks are installed, they are similar to other 
installed tasks. You cannot, however, count on the presence of a 
task installed through install-run-remove. 

Several situations require tasks to be explicitly installed 
through INSTALL. If you wish for other tasks to be able to 
communicate with the task while it is not active, it must be 
installed. If you wish to run the task on a schedule, it must be 
installed and then scheduled using the RUN command. If a task is 
commonly used, you may wish to sacrifice pool space to improve 
system performance by installing the task. 

You can display the attributes of installed tasks with SHOW 
TASKS/INSTALLED. See Section 7.12.5. 

Error Messages 

INS — Access to common block denied 

Explanation: Command attempted to access a common that was 
installed specifying a protection status that excludes you. 

User Action: Find out why protection was established in that 
fashion and proceed accordingly. 

INS — Addressing extensions not supported 

Explanation: Command tried to install a task with a VSECT 
(virtual section) in a system that does not support this feature. 

User Action: None. 
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INS — Base address must be on 4K boundary 

Explanation: The base virtual address of the task was not on a 
4K boundary. 

User Action: Relink the task. 

INS — Can't install privileged task from non-privileged terminal 

Explanation: A nonprivileged user attempted to install a 
privileged task through the install-run-remove form of RUN. 

User Action: None. 

INS — Checkpoint area too small 

Explanation: The area allocated for checkpointing the task was 
smaller than the partition into which the task was being 
installed. 

User Action: Allocate more checkpoint space using SET 
DEVICE/CHECKPOINT and reenter the command. 

INS — Checkpoint space too small, using checkpoint file 

Explanation: Warning message. The checkpoint space allocated in 
the task image file is too small for the size of the task 
(probably because of the /EXTENSION qualifier). The system 
supports dynamic allocation of checkpoint space and will 
therefore use a checkpoint file on the volume to contain the task 
if it must be checkpointed. 

User Action: None necessary. The task can be relinked with more 
checkpoint space, or you can remove it and reinstall it with a 
different value for /EXTENSION if you wish. 

INS — Common block not loaded common-name 

Explanation: The specified common block was linked to the task 
but had not been installed. 

User Action: Install the common block, then install the task. 

INS — Common block parameter mismatch common-name 

Explanation: Parameters of a common block did not match those in 
the task's label block. 

User Action: Correct the mismatch. 

INS — File not contiguous 

Explanation: Command attempted to install a task from a 
noncontiguous file. Task images must be contained in contiguous 
files. 

User Action: Make sure you have specified the correct file. 
Reenter the command. 
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INS — File not task image 

Explanation: Command attempted to install a task from a file 
whose label block indicated it was not a task image. 

User Action: Make sure you have specified the correct file. 
Reenter the command. 

INS — Illegal device ddnn: 

Explanation: Warning message. The device specified at 
task-build time by the ASG option is not in the system. The task 
will be installed but may not execute as you wish. 

User Action: Determine the impact of the omission and act 
accordingly. 

INS — Illegal device/volume 

Explanation: Command specified a device that was not a valid 
task-residence device. 

User Action: Make sure you specified the proper device and 
reenter command. 

INS — Illegal first APR 

Explanation: A privileged task, built to run using APR 4 or 5 as 
its base, was too large. Using APR 4, the task was larger than 
12K; using APR 5, the task was larger than 8K. If the Executive 
has been built to support 20K of address space, APR 5 is the only 
valid base APR for tasks mapping into the Executive. A 
privileged task that does not map into the Executive must use APR 
as its base. 

User Action: See the RSX-11M/M-PLUS Task Builder Manual for a 
description of the /PR keyword (/PRIVILEGED qualifier to LINK) . 

INS — Illegal priority 

Explanation: Command specified a priority value of less than 
or greater than 250. 

User Action: Reenter command after checking proper syntax. 

INS — Illegal use of parname partition or region 

Explanation: Command attempted to install task into a CPU or 
secondary pool partition. 

User Action: Reenter command, specifying proper partition. 

INS — Length mismatch common block blockname 

Explanation: The length parameter for the common block, as 
described in the label block for the task image, did not match 
the length parameter defined in the system. A task's label block 
data must match system data for that task before it can be 
installed. 

User Action: See your system manager. 
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INS — No checkpoint space, assuming not checkpointable 

Explanation: Warning message on systems that do not support 
dynamic allocation of checkpoint space. Command attempted to 
install the task as checkpointable, but the task was not built as 
checkpointable and therefore had no checkpoint space allocated. 
Since the system does not support dynamic allocation of 
checkpoint space, the system considers the task to be not 
checkpointable. 

User Action: If you wish, you can relink the task as 
checkpointable. 

INS — No pool space 

Explanation: No dynamic memory (DSR) was available for the 
Common Block Directory (CBD) or Partition Control Block (PCB) . 

User Action: Wait. Pool space may free up soon. If it does 
not, see your system manager. 

INS — No room available in STD for new task 

Explanation: No dynamic memory (DSR) was available for Task 
Control Block (TCB) in the System Task Directory (STD). Task 
cannot be installed. 

User Action: Wait. Pool space may free up soon. If it does 
not, see your system manager. 

INS — Not enough APRs for task image 

Explanation: The Task Builder allows you to specify the virtual 
base address of a task image as a multiple of 4K. Privileged 
tasks start at virtual 100000 (octal) to map the 16K Executive or 
virtual 120000 (octal) to map the 20K Executive. If the virtual 
base address is set too high, the task image may not be able to 
be mapped with the remaining mapping registers. 

User Action: See the RSX-11M/M-PLUS Task Builder Manual for more 
information on the /PR keyword (/PRIVILEGED qualifier to LINK) . 

INS — R/0 partition parname not in system defaulting to task's 
partition 

Explanation: Warning message. Command attempted to install a 
read-only common in a nonexistent partition. Common was 
installed in task's partition. 

User Action: If you wish, you can create the missing partition. 

INS — Specified partition too small 

Explanation: Command attempted to install task in a partition 
that was smaller than the task. 

User Action: Increase the size of the partition and reenter 
command . 
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INS — Task image already installed 

Explanation: The requested task image, which was checkpointable, 
had already been installed. On systems that do not support the 
dynamic allocation of checkpoint space, checkpointable tasks that 
have checkpoint space allocated can be installed only once. 
Other tasks can be installed more than once (under different 
names) . 

User Action: If the system has dynamic allocation of checkpoint 
spaces rebuild the task without task checkpoint space. 
Otherwise, make the task noncheckpointable. 

INS — Task image I/O error 

Explanation: INSTALL either could not read the task image file, 
or could not rewrite the task image header because the device was 
write-locked. 

User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your system manager. 

INS — Task image virtual address overlaps common block blockname 

Explanation: The virtual addresses reserved for the task image 
overlap those reserved for the common block named in the message. 
A corrupt task image file probably caused the overlap. 

User Action: Determine the state of the task image file and 
correct the error if you can. You may have to rebuild the task. 

INS — Task name already in use 

Explanation: Command attempted to install a task with the same 
name as one already in the system. 

User Action: Determine if the two tasks are the same. If not, 
install your task using the /TASK_NAME qualifier to change the 
name. 

INS — Too many common block requests 

Explanation: Task made too many common-block requests. 

User Action: Tasks are limited to seven common-block references. 
This error can result from an improper task build or coding 
errors. Find the cause of the error and correct it. 

INS — Too many LUNS 

Explanation: Task requested more than 250 LUNs to be assigned. 

User Action: Recheck task build and code for source of the error 
and correct it. 
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INS — WARNING — Privileged task overmaps the I/O page 




User Action: Determine the cause of the error and correct it if 
necessary. 



7 . 9 REMOVE 

REMOVE takes a task name out of the System Task Directory. The task 
is no longer installed. 

REMOVE/REGION takes the name of a region out of the Common Block 
Directory and the partition list. 

This is a privileged command. 

Format 

REMOVE [/qualifier] 
Task? taskname 

REMOVE [/qualifier] taskname 

Command Qualifier 

/REGION 
Parameter 
taskname 

Specifies the name of the task you wish to remove. 

If you wish to remove a region, specify the /REGION qualifier and 
the name of the region. 

Command Qualifier 

/REGION 

Specifies that rou ~\sh to remove a region from the Common Block 
Directory. This qualifier is for RSX-11M-PLUS systems only. 

Examples 

>REM0VE UONTON 

This example removes the task named WONTON from the System Task 
Directory. It is no longer installed. 
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>REHOVF/REGrON DON JON : ■ " . ' ^ . ' 

This RSX-11M-PLUS example removes the common region named DONJON 
from the Common Blocks Directory. ;; i ■ ' ■ , ' f, ~' ! <: " ■ ' ■ ; ■ 

Notes 

To remove an active task, you must first abort it. 

If a task is fixed, REMOVE first unfixes it and then removes it. 

REMOVE cancels all time-based requests for the task to run. 

REMOVE deallocates all receive-by-ref erence and receive-data 
packets for the task and detaches all attached regions. See the 
RSX-11M/M-PLUS Executive Reference Manual for more information. 



7.10 FIX 

FIX causes an installed task or region to be loaded and locked into 
memory. Subsequent requests for the task or region may be serviced 
more quickly because it is memory-resident and does not have to be 
loaded from the disk. 

This is a privileged command. 

Format 

FIX[/qualifier] 
Task? taskname 

FIX[/qualif ier] taskname 

Command Qualifiers 

/READONLY SEGMENT 
/REGION 

Parameter 

taskname 

Specifies the installed task or region you wish to fix in memory. 

Command Qualifiers 

These qualifiers are for RSX-UM-PLUS systems only. If you do 
not specify a qualifier, an installed task is fixed in memory. 

/READON L f SEGMENT 

Allows you to fix in memory the read-only segment of a multiuser 

task . 

/REGION 

Allows you to fix in memory a common region. 
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>FIX ACNT 



>SH0W TASK/ INSTALLED/FULL ACNT 

ACNT 061/24 GEN 100630 02264100-02342000 PRI - 50, DPRI - 50, 

STATUS t ~EXE --CHK -PHD PPM FXD 

TI - NONE IOC - EFL6 - 000000 000000 

>UNFIX ACNT 

>SHO TAS INS FU ACNT 

ACNT ' 061724 GEN 035370 0047000-00554700 PRI - 50. DPRI - 50, 

STATUS I -EXE -CHK -PHD PRV 

TI - NONE IOC - 0, EFLG - 000000 000000 

In this example, the user fixed in memory the installed task 
ACNT. The task's status, as displayed, includes the mnemonic FXD 
under STATUS and also gives the task's location in the partition 

GEN. 

Notes 

UNFIX and REMOVE counteract FIX. 

After a task is fixed, it need not be loaded into memory because 
it is already memory-resident. Requests to run the task can be 

coriiiro/1 mr\ro mil rtl w 
.. . ... — ^ j . 

Fixed tasks remain memory-resident even after they exit or abort. 

Fixing a checkpointable task makes it noncheckpointable. 

Active tasks cannot be fixed. However, a task must be installed 
before it can be fixed. 

The system can fix a task in memory only when the partition in 
which it is to be fixed becomes available. 

Not all tasks will run properly when fixed. Certain tasks may 
require data areas to contain certain values when loaded in from 
the disk. The first time the task is run, these data areas may 
be modified and the task may run unpredictably thereafter. Tasks 
that initialize their data areas, and therefore do not have this 
problem, are called serially re-entrant. 

Overlaid tasks may be fixed and, if their root segments are 
serially re-entrant, will run correctly. However, since their 
overlaid segments must still be read in from disk (unless the 
task was built using memory-resident overlays) , not much is 
gained by fixing them. 

Error Messages 

FIX — Partition busy 

Explanation: The partition in which the task was to be fixed is 
occupied, so the task cannot be fixed. 

User Action: Wait or install the task in another partition. 
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FIX — Task already fixed 

Explanation: The specified task is already fixed. 

User Action: None. 

FIX — Task being fixed 

Explanation: The specified task is in the process of being 
fixed. 

User Action: None. 



7.11 UNFIX 

UNFIX frees a fixed task or region from memory. The effect is to 
allow tasks that have been waiting for space in the partition in which 
the fixed task resides to compete for that space. 

This is a privileged command. 

Format 

UNFIXf/qualifier] 
Task? taskname 

UNFIXf/qualifier] taskname 

Command Qualifiers 

/REGION 

/ READGNLYJ3EGMENT 

Parameter 

taskname 

Specifies the name of the task you wish to unfix. 

If you wish to unfix a region, specify the name of the region for 
this parameter. 

Command Qualifiers 

These qualifiers are fpr RSX-1.1M-PI.US systems only. 
/REGION 

Specifies that you wish to unfix a common region rather than a 
task. 

/READONLY_SEGMENT 

Specifies that you wish to unfix the read-only segment of a 
multiuser task. 

Example 

See example in Section 7.10. 
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Notes 

A fixed task remains fixed after it exits or aborts. Therefore, 
it must be explicitly unfixed or removed. 

Error Message 

UNF — Task not fixed 

Explanation: Command attempted to unfix a task that was not 
fixed. 

User Action: None. 



7.12 SET AND SHOW 

All users can display information about partitions, active and 
installed tasks, the clock queue, and logical-unit-number assignments. 

Privileged users can establish and eliminate partitions and change the 
priority of active tasks. 



7.12.1 SET PARTITION 

SET [NOl PARTITION creates or eliminates partitions in system memory. 
This is a privileged command. 

A partition is a contiguous area of memory with a name, a size, a 
fixed base address, and a type. 

RSX-11M partitions can be of four types: system-controlled, 
task-controlled, common regions, and device commons. In addition, 
task-controlled partitions can have subpartitions. 

**«.. ■ -. *.. m.» *<r . i...;'*. .: ~v w ~ .■. ~ u « *. c «- *.«^ ' *- ■ t *\ n r« . ty i »«"•+- in m /^rtrtt-rnl I orl n V 

>i; A.— 1 S.m~l UIJZ, \J(iL i, L \- J.UUS <-<.'i: IT •■ v>-.-' - » J ~ul . &jr^>_*-i.. «..*»••■• ^ •. ^--ws. — 

device commons. , .''.;.■.:;.; :! ' !:::; ■.'..•"'■'■■ ■[,, '"':'■■'■"' ■ ,:. :i ; 

Format 

SET NOPARTITION:parname 

SET PARTITION :parname/qualifier[s] 
Base? n 
Size? n 

Required Qualifiers 

/BASE:n 
/SIZE:n 

Qualifier 

/TOP:arg 
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RSX-11M Partition Types 

/COMMON 

/DEVICE 

/SYSTEM 

/TASK 

/TOP:arg 

/ [NO] SUBPARTITION : subpa rname 

RSX-11M-PLUS Partition Typ*;: 

/DEVICE . V-v"\/ v" ■ " ' ; 

/DIAGNOSTIC 

/system' ' . . : '..'; ., ; ■■■ ' .. 
Required Argument 
parname 

Partition names are from one through six Radix-50 characters. 
Each partition (or subpartition) must have a name. 

SET NOPARTITION eliminates the named partition. 

Required Qualifiers 

/BASE:n 

Specifies the starting address of the partition. n is the 
physical base address specified in 64-byte units. 

/SIZE:n 

Specifies the size of the partition, n is the size in 64-byte 
units. 



The argument for the base and size of the partition can be 
entered in a number of formats. In all formats, n is a number 
that is multiplied by a factor to calculate the value to be used. 
See Table 7-1. 

Table 7-1 
Base and Size Specifications for SET PARTITION 



Calculated 
Format Value Base Range Size Range 



Octal nnnn (nnnn*100) 0<base<177777 0<size<2000 

Decimal nnnn. (nnnn.*640) 0.<base<65535. 0<size<1024. 

Octal K nnnK (nnn*4000) 0<base<3777K 0<size<40K 

Decimal K nnnK (nnn.*2048.) 0<base<2047.K 0.<size<32.K 



For system-controlled partitions, these values can range from 
through 1920. K, or any valid representation of these limits. The 
upper limit is the size of your system's memory. 
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Qualifier 

/TOPrarg 



The /TOP qualifier moves the top boundary of the specified system 
according to the form the argument is stated in. The argument is 
a number of 64-byte blocks, expressed in one of the five 
following formats: 

+n Moves the top boundary of the partition up by the 
specified amount, making the partition larger. 

-n Moves the top boundary of the partition down by the 
specified amount, making the partition smaller. 

n Makes the partition the specified size by moving the 
top boundary. 

[+]* Moves the top boundary of the partition up as far as 
possible. 

-* Moves the top boundary of the partition down as far as 
possible. 

Partition Types 

/SYSTEM 

Both RSX-11M and RSX-11M-PLUS have system partitions. System 
partitions are sometimes called system-controlled partitions. 
They are the most common type of partition on mapped systems. 
All systems including DCL are mapped systems. 

In system partitions, the Executive allocates available space to 
accommodate as many tasks as possible at one time. This 
allocation may involve moving resident tasks to arrange available 
space into a contiguous block large enough to contain a requested 
task. 

/DEVICE 

Both RSX-11M and RSX-11M/M-PLUS have device partitions. Device 
partitions are device commons, which are used by tasks to access 
the device registers of the I/O page. Device commons provide 
direct access to specialized I/O equipment, such as that used in 
industrial and laboratory settings. See the Processor Handbook 
supplied with your system for more information on the I/O page. 



/TASK 



Only RSX-11M systems have task-controlled partitions. 
Task-controlled partitions are sometimes called user-controlled 
partitions. Task-controlled partitions are generally used for 
real-time applications where explicit control of memory 
allocation is important. Task-controlled partitions are 
exclusively allocated to one task at a time unless divided into 
subpartitions. 
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/[NO] SUBPARTITION :subparname ,;■ ., '.-.,:.: , ■■■ . , . 

Only RSX-11M systems have subpartitions. Task-controlled 
partitions can be divided into as many as seven subpartitions. 
SET PARTITION/NOSUBPARTITION eliminates the named subpartition. 

/COMMON 

Only KSX-11M systems have ;cmmon partitions. Common partitions 
are sometimes called common regions. Common partitions are used 
for task communications or data or code used in common by more 
than one task. See the RSX-11M / M-PL US Task Builder M anual for 
more information on common regions. 

/DIAGNOSTIC - ■ ■ , " " - . ■ r ;" -:• ■ ' /[ ' ; '■■>,. . ■ , ; ' .•..•', , : ; ; , , ■ 

Only HSX-11M-PLUS systems have diagnostic partitions. They are 
used for diagnostic functions on multiprocessor systems. Th? 
■specified partition is created without checking the top of 

; memory. : ;,.'",' _ , ' ^ ',,,; ' , '*" ,,, : 

Examples 

>SET PARTITION STOMP AR/SYSTEM 

Base? 002010 

Size? 1000 

>SH0U PARTITIONS TOMPAR 

par=tompar: 0020 10:1000 J SYS 

This example creates a partition named TOMPAR with a base address 
of 002010 and a size of 1000 (octal) bytes. The partition is 
system-controlled. Since this is the default, the user need not 
have specified /SYSTEM in the command. 

The display from SHOW PARTITIONS is slightly different on RSX-11M 
systems in that the word MAIN appears where PAR appears in this 
example. 

>SET NOPARTITIQN 

Partition name? TOMPAR 

>SH0W FARTITI0NST0HPAR 

SET -- Partition not in system 

This example eliminates the partition TOMPAR. 

>SET NOPARTITIONSTSTPAR/MOSUBPARTITItW 
Subpartition name? SMOKE; 

This RSX-11M example eliminates the subpartition SMOKE from the 
task-controlled partition TSTPAR. 



Notes 



Partitions are one of the key elements in tuning RSX-11M/M-PLUS 
systems and making the best use of available memory. 

You can specify the partition you wish your task to run in with 
the PAR option of the LINK command. You can override this 
specification with the /PARTITION qualifier to the INSTALL or RUN 

commands. 
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A system partition cannot include subpartitions specifically 
defined by the SET command. The Executive dynamically defines 
subpartitions in a system partition as needed for tasks installed 
in the partition. You should not confuse these dynamic 
partitions containing tasks with the task-controlled partitions 
of RSX-11M. 

On RSX-11M systems only, you can define subpartitions of 
task-controlled partitions with the SET command. 

You can display the name, size, address and type of one or more 
partitions with the SHOW PARTITIONS command (Section 7.12.2) . 
You can display the allocation of partitions in memory 
graphically with the SHOW MEMORY command (Section 8.1.9). 

See the RSX-11M/M-PLUS Task Builder Manual for information about 
tasks run in partitions. 

If a partition currently contains an installed task, common, or 
loaded driver, you cannot eliminate it with SET NOPARTITION. 

If, on an RSX-11M system, you eliminate a task partition, you 
automatically eliminate any subpartitions associated with it. 

Error Messages 

SET — Alignment error 

Explanation; Command attempted to create a partition but the 
base address or size conflicted with existing partitions or with 
the size of physical memory. 

User Action: Check command for proper values and reenter. 

SET — Nonexistent memory 

Explanation: Command attempted to define a partition in 
nonexistent memory. 

User Action: Check command for proper values and reenter. 
SET — Partition already exists 

Explanation: Command attempted to define a partition with a name 
already in use. 

User Action: Use another name. 

SET — Space used 

Explanation: Command attempted to create a partition in a 
storage area already occupied. 

User Action: Check command for proper values and reenter. 

SET — Task installed in partitions 

Explanation: Command attempted to eliminate a partition 
containina an installed task. 
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User Action: Determine the cause of the error and proceed 
accordingly. 

SET — Too many subpartitions 

Explanation: An RSX-11M user attempted to define more than seven 
subpartitions in a task partition. 

User Action: None. You are limited to seven subpartitions. 

SET — Unknown main partition 

Explanation: An RSX-llM user attempted to create subpartitions 
in a nonexistent task partition. 

User Action: Determine the cause of the error and take 
appropriate "action.., .";"' : "" 



7.12.2 SHOW PARTITIONS 

SHOW PARTITIONS displays address and content information about the 
partitions of the system. You can display information about all 
partitions or about a single partition. 

Format 

SHOW PARTITIONS [:parname] 
Parameter 

If you do not specify a partition name, all partitions in the 
system are displayed. The format of the display is as follows: 

parname pcbaddr baseaddr parsize MAIN 

If the partition includes subpartitions, this description is 
followed by one or more lines describing the contents of the 
subpartitions. The format of these lines is as follows: 

pcbaddr baseaddr parsize partype contentname 

In both of these displays, parname is the name of the partition, 
pcbaddr is the address of the Partition Control Block (PCB) , 
baseaddr is the starting address of the partition or 
subpartition, parsize is the size of the partition in bytes, and 
partype is one of the following: 

MAIN Main partition 

TASK Dynamic task subpartition - not /TASK 

(user-controlled) 

SUB Subpartition - RSX-11M only 

DRIVER Device driver partition 

RO COM Read-only common partition 

RW COM Read-write common partition 

DEVICE Partition is a common mapped to the I/O page 

SEC POOL Partition is a secondary pool 
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In addition, contentname is indicated as follows: 



[taskname] 
<TASKNAME> 

(TASKKAME) 

(ddO ' 
-dd: 
+ xxxx + 



! yyyy • 



An inactive resident task 

An active task on RSX-11M-PLUS 

An active : :-:<- on RSX-11M 

Indicates specific device drivci on RSX-11M-PLUS 

Indicates specific device driver on RSX-11M 

Indicates the name of the first 

installed task that is associated with a 

an unnamed common, usually the read-only 

segment of a multiuser task 

Indicates the name of the common 



parname 



Specifies the name of the partition about which you wish 
information to be displayed. When you specify a partition, the 
displsy on RSX-llM-PLUS format is as follows: 

PAR= parname :baseaddr :parsi zc : SYS 

In this display, the address and size fields of the single 
partition display are 64-byte values (octal 100; , wnile in the 
multiple partition display, byte values are displayed. See 
examples. 

On RSX-11M, the display is identical for system partitions. For 
task (user-controlled partitions), any subpartitions are also 
displayed, as follows: 

MAIN=par name : baseaddr : par si ze : TASK 
SUB=parname:subparname:baseaddr: par size 



Examples 



>SH0W PARTITIONS 

SYSPAR 035720 00201000 00010000 MAIN 
036330 00201000 00010000 TASK 



:HCR 



DRVPAR 035610 00224000 00140000 MAIN 

035324 00224000 00002600 DRIVER (DEI) 
035260 00227600 00001300 DRIVER <DK:> 



LDRPAR 035544 00364000 00003000 MAIN 
033774 00364000 00003000 TASK 



, LDR 



SECP0L 035434 00427000 00050000 SEC POOL 

GEN 035370 00477000 04701000 MAIN 

117210 00477000 00024000 RW COM IFCSFSL. 

041324 00523000 00004400 TASK < POOL. 

062124 00545100 00012600 TASK < I..PP0 
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046340 00763300 00006100 TASK 



This_ example shows the display from SHOW PARTITIONS when no 
partition is named, Information on all partitions and dynamic 
task subpartitions in the system is displayed. DRVPAR contains a 
number of device drivers, each in its own subpartition. Notice 
that SYSPAR's base address is 00201000 and its size is 10000 
(octal) bytes. See next example. 

>SH0U PARTITION*. SYSPAR 
PAR=SYSPAR: 0020 10! 000 1005 SYS 

This example shows the display from SHOW PARTITIONS when a 
partition is named. No information about subpartitions or about 
any tasks in the partition is displayed. Notice that SYSPAR's 
base address is given as 002010 and its size is 100 64-byte 
blocks. 

>SH0W PARTITION'.TSTPAR 

MAI N = TSTPAR 5 003657 5 000700 5 TASK 

SUB-TSTPAR: SMOKE '0036575 000010 

This RSX-11M example shows the display when SHOW PARTITIONS names 
a task-controlled partition that includes a subpartition. 



Notes 



SHOW PARTITIONS unadorned is the equivalent of the MCR PAR 
command. 

SHOW PARTITIONS with a partition name is the equivalent of the 
MCR SET /PAR=parname command on RSX-11M-PLUS or the MCR SET 
/MAIN=parname command on RSX-11M. 



7.12.3 SHOW TASKS 

You can display information about active and installed tasks on the 
system in a number of ways. Section 7.12.3.1 covers the display of 
static information about tasks active on your terminal or elsewhere on 
the system in full or brief format. Section 7.12.3.2 explains the 

f^ifinlpv r%£ .Ci-Al-lr« 1 n fr\ rmsi 4-i^t-. aN/Mif T»-»r.+--a"]"l rt ,3 *. ^ ~ 1* « -I— jr. .11 I £ - c 

£ J ~ — ~w—.,- v ..ii i_ v i. »iiu ^ j. V n mwwuu iiioi.aii.cu UCIOflO til lull Ut UX1KI 

format. Section 7.12.3.3.1 explains the dynamic display of 
information about active tasks and Section 7.12.3.3.2 explains the 
dynamic display of the Active Task List. Section 7.12.3.4 explains 
the display of the LUNs of an installed task. 
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7.12.3.1 SHOW TASKS/ACTIVE 

SHOW TASKS/ACTIVE displays information about active tasks in brief and 
full format. 

Brief Format 

>SHOW TASKS/ACTIVE [:ttnn:] [/qualifier [s] ] 

Command Qualifiers 

/BRIEF 
/ALL 

ttnn: 

If you name a terminal in the command, the display shows in brief 
form the tasks active at that terminal. If you do not name a 
terminal, the display shows in brief form the tasks active at 
your terminal. 

Command Qualifier 

/BRIEF 

Specifies that you wish to display information about active tasks 
in the brief format. This is the default and need not be 
specified. 

On RSX-11M systems, the brief format includes task names only. 

On RSX-11M-PLUS systems, the brief format includes task names and 
the originating terminal in parentheses next to eacr task ...:me. 



/ALL 



Specifies that you wish to display information about all tasks 
active on the system. The default is to show information about 
tasks active at your terminal only. 



Examples 



>SH0W tasks/ active: 

MCR... (TTSt) 
SHOTS <TT5:> 

This example shows the brief display from SHOW TASK/ACTIVE. In 
this case, the tasks are MCR..., the central command dispatcher, 
and SH0T5, the SHOW task itself. 

On RSX-I1M-PLUS systems, the terminal from which the task is 
running is also displayed. .,.., ,,.-/ s, "';■' ,'>■,,;';;;;,, ''^ "";;■■ .:;;, riii ", : ../"y- -.""„;_; ^ 

>SH0W TASKS/ACT I UE/ALL 
LDR... <COOJ) 
KMDEML. (TTOi) 
SH0H2 -;HT2S) 
NETACP <C00:> 

«PO I TTt I * 1 
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yC-.T5 <TTSJ) 
Hi"! Oft. I- <C00;> 



Ti'56 diss:) 
EDIT 25 <TT25t) 

t.o c t30 •; r.TAOs ; 



This example shows the brief display from SHOW TASK/ACTIVE/ALL. 

On RSX-.11M-PLUS systems, the terminal from which the task is 

running is also displayed. 



Full Format 



SHOW TASKS/ACTIVE/FULL [taskname] 
SHOW TASK [: taskname] /ACTIVE/FULL 

taskname 

If you include a task name, the display shows full information on 
that task. If you do not name a task, the display shows full 
information on all currently active tasks. 

Command Qualifier 

/FULL 

Requests the full format display for the SHOW TASK/ACTIVE 
command. This format includes detailed information on the state 
of one or all tasks active on the system. The format of the 
display is as follows: 

taskname tcbaddr parname pcbaddr taskaddrlimits pri defpri 

STATUS: statusflags 

TI - ttnn: IOC - iocount BOC -buffiocount EFLG -eventflags PS -pswval 

PC - pcval REGS 0-6 rrlval r2val r3val r4val r5val r6val 



In this display: 
tcbaddr 

parname 
pcbaddr 

taskaddrlimits 

pri 

defpri 

STATUS 



The physical address of the Task Control 
Block (TCB) 

The name of the task's partition 

The physical address of the Partition 
Control" Block (PCB) 

The base and top of the task's dynamic 
subpartition as physical addresses 

The priority at which the task is actually 
running 

The default priority at which the task was 
built or installed to run. 



The task's status flags, 
identified in Table 7-2. 



These 



are 
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TI The initiating terminal 

IOC The decimal I/O count for the task 

BIO The decimal count of I/O buffered by the 

terminal driver and Executive 

EFLG Local event flags 

pswval The Processor Status Word 

pcval The Program Counter 

REGS The contents of the task's other registers. 

If the task was spawned by another task, the 
name of the parent task is also displayed. 

If the task is not in memory (OUT flag displayed, see Table 7-2), 
the PC, PSW, and other registers are not displayed. 

This display shows the state of the task at the time the command 
was issued. You can display similar information dynamically (in 
real time) for a single task with the /DYNAMIC qualifier, as 
explained in Section 7.12.6. 

Table 7-2 
Task Status Flags 



Meaning 

Being aborted 

Ancillary Control Processor 

AST state 

Blocked externally by CLI command 

Checkpoint space allocated in task image 

Not checkpointable 

Blocked for checkpoint in progress 

(RSX-11M-PLUS only) 
Checkpointing disabled 
Checkpoints (KSX-11M-PLUS only) 
' . h !-. t ' k po i n t ■ n L i ? q r e 3 s i r c I i e c k po i n t e d 

(RSX-11M only) 
Checkpoint request pending 
Command Line Interpreter 
ASTs disabled 
Not executing 
Fixed in memory 

Task has own group global event flags locked 
Half-loaded, awaiting pool for task header 
Being terminated 
Activated by MCR 

Aborted, waiting for TKTN message 
Network protocol level 
Cannot receive data (no send data allowed) 

(Continued on next page) 
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Status 


TCB 


Flag 


Flag 


ABO 


T2.AB0 


ACP 


T3.ACP 


AST 


T2.AST 


BLK 


TS . STP 


CAF 


T2.CAF 


CAL 


T3.CAP 


-CHK 


TS.CHK 


CIP 


TS.CIP 


CKD 


TS.CKD 


CKP 


TS.CKP 


CKR 


TS.CKR 


CLI 


T3.CLI 


DST 


T2.DST 


-EXE 


TS.EXE 


FXD 


T2.FXD 


GFL 


T3.GFL 


HLD 


TS.HLD 


HLT 


T2.HLT 


MCR 


T3.MCR 


MSG 


TS.MSG 


NET 


T3.NET 


NSD 


T3.NSD 
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Table 7-2 (Cont.) 
Task Status Flags 



Status 


TCB 


Flag 


Flag 


-PMD 


T3.PMD 


OUT 


TS . OUT 


PRV 


T3.PRV 


RDN 


T3.RDN 


REM 


T3.REM 


REX 


T2.REX 


ROV 


T3.ROV 


RST 


T3.RST 


SEF 


T2.SEF 


SLV 


T3.SLV 


SPN 


T2.SPN 


SPN A 


T2.SPN 


STP 


T2.STP 


STPA 


T2.STP 


SWS 


T3.SWS 


WFR 


T2.WFR 


WFRA 


T2.WFR 



Meaning 



DSP 
LDD 

HUT 
PRO 
PRV 
SNC 



Suppress PMD on SST abort 

Out of memory 

Privileged 

I/O being run down 

Remove on exit 

Abort AST effected or in progress 

Resident overlays 

Restricted - used by layered software 

Stopped for event flag 

Slaved 

Being suspended 

Suspended prior to AST 

Stopped 

Stopped prior to AST 

Reserved for software services 

In a wait-for state 

In a wait-for state prior to AST 



RSX-llM-PLUS-only Task Status Flags 



T4.DSP 
T4.LDD 
T4.MUT 

1*4. PRO 
T4.PRV 
T>° . SNC 



Task was bui.1t: for user-mode I- and D~&pace 
Task's load device har> been dismounted 

T ask i .5 lis u 1 1 i u s e t t a s k 

Task is (or should i>e) a prototype task 

Task uses commons for synchronization 



Note: These status 
SHOW TASK command, 
within the task and 
identify certain k 
indicate the complem 
task is noncheckpo 
runs tasks to unders 
the RSX-11M/M-PLUS 
Executive Reference 



flags are displa 
They give inf 
between the task 
inds of tasks 
ent of the condi 
intable. You m 
tand the meaning 

Task Builder 

Manual , and the 

Manual for more 



Analyzer Reference 

has a full explanation of the conten 



yed by several forms of the 
ormation on what is happening 

and the system. They also 
Names prefixed by a minus (-) 
tion. Thus, -CHK means the 
ust understand how the system 
s of all these flags. See 

Manual , the RSX-11M/M-PLUS 
RSX-11M/M-PLUS Crash Dump 

information. The CDA manual 
ts of the TCB. 



Examples 



■SHQU TAS/ACT/FULL TT7 

"T? 066734 GEN 064244 01676500-02062100 PRI - 50. DPRI - 
STATUS! -CHK WFR -PMD REM MCR 

TI - TT7J IOC - 1, EFLG - 000000 040000 PS-70004 PC-072132 
REGS 0-6 041130 051172 000000 000040 010400 051520 001472 



50. 



This example shows the display in full format for the task named 
TT7 (initiated by a RUN command from terminal TT7:). The task is 
running in the default partition GEN at a priority of 50. The 
task is not checkpointable. It is in a "wait-for" state. No PMD 
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will be generated. The task is to be removed on exit (meaning it 
was installed with the install-run-remove form of RUN) , and it 
was activated by MCR. (Many tasks requested from DCL are 
actually activated by MCR.) 

>sh0 tas/act/ful 

. ,.ldr 034210 ldrpar 033774 00364000-00367000 pri - 248. dpri - 248. 

status: stp - pmd prv nsd fxd 

ti - c00: ioc - 0. eflg - 000001 000000 ps - 170000 pc - 120526 

REGS 0-6 000162 024207 177777 066640 066610 066314 120250 

rmdemq 046320 gen 046640 01367700-01415100 pri - 225. dpri - 225. 
status: -chk ufr -pmb prv mcr 
ti - tt62: ioc - 0. eflg - 000035 040000 ps - 170010 pc - 125014 

REGS 0-6 000002 131316 131436 000000 135055 000000 121240 
MCR,., 116464 SYSPAR 036330 00201000-00211000 PRI - 160. DPRI - 160. 

STATUS: STP -PMB PRV CLI NSD CAL 

TI - TTO: IOC - 0, EFLG - 000001 040000 PS - 170000 PC - 124412 

REGS 0-6 000000 120556 000400 120512 000100 120572 120442 
DCL... 115530 GEN 037344 00624700-00634700 PRI - 160. DPRI - 160. 

STATUS: STP -PMD PRY CLI NSD CAL 

TI - TT10! IOC - 0. EFLG - 100001 040000 PS - 170000 PC - 124470 

REGS 0-6 025550 025550 000000 120426 123530 000000 120362 
SH0T10 066314 GEN 066610 02221700-02261700 PRI - 160. DPRI - 160. 

STATUS: -PMD REM PRV 

TI - TTIO: IOC - 0. EFLG - 000001 040000 PS - 170017 PC - 121202 

REGS 0-6 000000 131574 050712 000000 000000 000000 001216 
DBOOFl 117570 GEN 036770 00537000-00624700 PRI - 149, DPRI - 149. 

STATUS: STP ACP -PMB PRY NDS CAL ROM 

TI - COO: IOC - 0. EFLG - 000002 040001 PS - 170000 PC - 120546 



LPPO 061444 GEN 062504 00725200-00740000 PRI - 80, DPRI - 80. 

STATUS! STP PRV 

TI - COO! IOC - 0. EFLG - 000400 140000 PS - 170000 PC - 120644 

REGS 0-6 121526 121640 000115 124676 000000 000001 120342 

PARENT TASK NAME - GMG,.. 
LPF'l 062024 GEN 062374 01351200-01364000 PRI - SO. DPRI - 80, 

status: STP PRY 

TI - COO: IOC - 0. EFLG - 000400 040000 PS - 170000 PC - 120644 

REGS 0-6 120362 000061 000060 140164 140440 000000 120342 

riAnriiT x a o L-* iiAur nun 

r w r\ c. ix i inui\ ixniiL uiiui » < 

AT.T10 041174 GEN 040640 02062100-02142000 PRI - SO. DPRI - 80. 

status: sef STP ufr -PMD REM PRV MCR 

TI - TTIO*. IOC - 0. EFLG - 000000 140000 PS - 170010 PC - 141604 

REGS 0-6 123551 123416 000122 115530 000000 000000 120664 
QMG... 061340 GEN 056354 01327700-01351200 PRI - 75. DPRI - 75. 

STATUS! STP PRV 

TI - COO: IOC - 0. EFLG - 000000 040000 PS - 170000 PC ■- 120656 

REGS 0-6 121750 123350 122350 001006 000000 000000 120372 
EDIT10 057420 GEN 057340 02142000-02262100 PRI - 65. DPRI - 65. 

STATUS! WFR -PMB REM 

TI - TTIO! IOC - 0. EFLG - 000002 100000 PS - 170000 PC - 006706 

REGS 0-6 000001 000000 017764 000000 103666 1015708 001700 

PARENT TASK NAME - AT.T10 
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This example shows the display from SHOW TASKS/ACTIVE/FULL. 
Tasks are displayed in order of priority. Note the tasks 
displayed below the first break. Tasks LPPO and LPP1 are 
line-printer processors. They are spawned by the Queue Manager. 
AT.T10 represents an indirect command file that spawns EDT by 
including an EDIT/EDT command, but the resulting task EDIT10 is 
not slaved. 



7.12.3.2 SHOW TASKS/INSTALLED 

SHOW TASKS/INSTALLED displays information about installed tasks in 
either brief or full format. 

Format 

SHOW TASKS [:taskname] /INSTALLED [/qual if ier] 

Command Qualifiers 

/BRIEF 
/FULL 

Parameter 

taskname 

Specifies the task for which you wish information displayed. If 
you do not specify a task name, information on all installed 
tasks is displayed. 

Command Qualifiers 

/BRIEF 

Requests information on installed tasks in a brief format. This 
is the default and need not be specified. The format of the 
display is as follows: 

taskname ident parname priority size ddnn:-lbn [memstate] 

In this display, taskname is the name of the task, ident is the 
task version identification (or the version of the prototype 
task), parname is the partition in which the task is installed, 
priority is its priority, size is the size of the task in bytes, 
ddnn: is the device from which it is to be loaded, lbn is the 
logical block number of its disk address an^ mamefai-a ^ e «-v^£» 
task memory state, which can be FIXED, CHECKPOINTED, or blank. 

If the task version identification is missing (with the rest of 
the line moved left) or if it is garbage, the task was installed 
from a disk that is no longer present. If the task version 
number is a date, such as 07JUL, the task was compiled on that 
day. 
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/FULL 



Requests the full format of the SHOW TASKS/INSTALLED command. 
This format displays a detailed list of the states of one or all 
of the installed tasks in the system, depending on the presence 
of the taskname parameter. The format of the display is as 
follows: 

taskname tcbaddr parname pcbaddr taskaddrlimits pri defpri 

STATUS: statusflags 

TI - ddn: IOC - iocount EFLG - eventflags 

This display is in the same format as that of SHOW 
TASKS/ACTIVE/FULL. See Section 7.12.4 for a description of the 
display. 



taskname 



Specifies a task for which full information is to be displayed. 
If you do not specify a task name, information about all 
installed tasks is displayed. 



Examples 








>SHOW TASKS/INSTALLED 




LDR. , . 


12.15 


LHRPAR 


248. 


TKTN 


04.7 


TKNPAR 


248. 


RMDEMO 


VI. 03 


GEN 


200. 


MTAACP 


ft 1 3 


RFN 


300. 


F11MSG 


V0010 


GEN 


200. 


NETACP 


V02.00 


GEN 


200, 


EVP, ♦ . 


VOL 00 


GEN 


199. 


. . ,MCR 


1. 1 


GEN 


160, 


SHOTS 


1.1 


GEN 


160. 


, . .MOU 


2502 


GEN 


160. 


, , .DCL 


00 


GEN 


160. 


MCR. ♦ , 


2.02 


SYSPAR 


160. 



00002500 LBOI-00163310 FIXED 

00010000 LB0: -00171022 

00026700 LB0S-00171022 

00013600 EMO! -00000315 

00025500 LB0:-0O167207 

00025500 DB0 : -00644640 

00013100 DB0:--00644640 CHECKPOINTS 

00020300 LBOt-00162467 

00020300 LBO: -00162467 

00037700 LBO*. -002224 16 

00035600 BBOt -00212612 

00010000 LBO : -00 1624 43 



This example shows the brief format of the display from SHOW 
TASKS/INSTALLED. LDR..., the loader, is fixed in memory. The 
task EVP... is checkpointed. The final entry shown, MCR..., is 
the system command dispatcher. See next example. 



>show/task:mcr,. ./installed/full 
mcr... 110160 syspar 11454 00202700-00212700 pri 
status: stp -pmd pro MCR cli nsd cal 



160 



TI 
PC 



tt: 



IOC 



0, BIO - 0. EFLG 



000001 040000 PS 



DPR I 



170000 



160 



122436 REGS 0-6 000000 120476 000102 120516 057020 040220 120366 



This example shows the full format of the display from SHOW 
TASKS/INSTALLED. In this case, the user named a single task. 
The default is to show the full display for all installed tasks. 
The status flags in the second line of the display are explained 
in Table 7-2. 
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Notes 



The brief format of SHOW TASKS/INSTALLED is the MCR TAS command. 
The full format of SHOW TASKS/INSTALLED is the MCR TAL command. 

The /DYNAMIC qualifier enables you to watch the full format 
display as it is updated. See Section 7.12.6. 



7.12.3.3 SHOW TASKS/DYNAMIC 

SHOW TASKS/DYNAMIC displays a moving picture on a video terminal of 
either a single task's activity, or of all or part of the Active Task 
List. 

The command also works on hard-copy terminals, providing a snapshot 
display that is different in format from the conventional SHOW TASKS 
display. 

This command is privileged if the Resource Monitoring Display (RMD) is 
not installed on the system. The command is nonprivileged if RMD is 
installed under the name ...RMD, or if your system supports flying 
installs. See your system manager for information. 



7.12.3.3.1 SHOW TASK:taskname/DYNAMIC 

SHOW TASKrtaskname/DYNAMIC displays a moving picture of the task's 
activity on a video terminal or a snapshot display on a hard-copy 
terminal . 

Format 

SHOW TASK : taskname/DYNAMIC [/qual i f ier] 

Command Qualifier 

/RATE:n 
Argument 
taskname 

Specifies the task you wish to inspect. 

Qualifiers 

/DYNAMIC 

Specifies that you wish the moving display. This function is 
performed by the RMD task. RMD has four display pages: 

• Task, which displays a task header 

• Active, which displays all or part of the Active Task List 

• Memory, which displays the contents of memory 

• Help, which provides help on RMD 
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Once you have invoked any one of these pages, through either a 
SHOW TASK/DYNAMIC command or a SHOW MEMORY command, you can move 
from one page to the other without leaving RMD. The first 
character of each page name is a command to RMD to go to that 
page. In addition, an ESC entered from a page permits you to 
enter setup commands for that page. See Section 8.1.9 for more 
information on the features of RMD. 

The setup commands for the Task page permit you to change the 
task header being displayed. The task you name remains the 
default display for the Task page. This means you can observe a 
single task header, then jump to the Memory page or the Active 
page, and then back to the Task page and the named task will 
still be on display. 

/RATE:n 

The /RATE qualifier allows you to set the rate at which the RMD 
display screen is to be replotted on the first display, n is the 
number of seconds between replots. The default n is 1. You can 
change the rate by pressing ESC and entering a new rate. The 
rate setting returns to 1 as soon as you change pages. If you 
wish a slower rate, you must reset the rate each time you change 
the page. 

Use this qualifier to slow down the display. 

Task headers may change more often than once per second, but once 
per second is the most rapid rate available. 

Example 

>SHOW TASKJCQRTS/DYNAMIC 
The screen is cleared and the following display appears: 

RSX-UH V4.1 BL33 512K 14-N0V-82 18515:33 

Task: C0RT5 Partition: GEN STATUS: -CHK -FMD REM FRV CL1 
Own: TT5: I/O = 0. DPri! 160 Pri: 160 SPri! 155 Len! 000356000 

R0 = 022120 Rl = 000764 R2 = 002230 R3 = 000746 R4 = 024626 R5 = 022136 
PC = 005330 PS = 170000 SP = 022224 *DSW = 0. EflS = 0000001 040000 

LUN File LUN File 

1. SYO! 

2. DB0:C3»33DDEEP.DAT 

3. SYO! 

4. syo: 

5. tio: 

6. clo: 

7. DBOt 

This display changes once per second and shows the task header 
for a task named C0RT5. The top line of the display identifies 
the operating system by name, version, base level and memory 
size, and also gives the date and time. The next line of the 
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display includes the task name, the partition in which the task 
is running, and the task's status flags. (See Table 7-2 for an 
explanation of the status flags.) The next line lists the task's 
owner (terminal, not UIC); the outstanding I/O count; the 
default priority, running priority, and swapping priority; and 
the length of the task in octal bytes (top minus base) . The next 
two lines display the contents of the task's general-purpose 
registers, program counter, Processor Status Word, stack pointer. 
Directive Status Word, and local event flags. The remainder of 
the display shows the logical-unit-number assignments of as many 
as 25 LUNs. (Tasks can have as many as 250 LUNs.) This task has 
conventional LUN assignments except for LUN 2, which is an open 
file. 



Notes 



You must understand how tasks run in the RSX-11M/M-PLUS 
environment to understand all the elements of this display. On 
the other hand, this display is a useful tool for understanding 
how tasks run on the system. 

Tasks built including ODT can be observed using this command, but 

if you are single-stepping through the task or otherwise using 

breakpoints, the registers displayed will be those of the ODT 
task, not those of the named task. 

This display is particularly useful for observing complex 
assemblies, as you can tell how far the assembly has gone by 
which files are open. You may also be interested in observing 
the Task Builder at work. 



7.12.3.3.2 SHOW TASKS/ACTIVE/DYNAMIC 

SHOW TASKS/ACTIVE/DYNAMIC displays a moving picture of the Active Task 
List on a video terminal or a snapshot display on a hard-copy 
terminal . 

Format 

SHOW TASKS/ACTIVE/DYNAMIC [/qualifier [s] ] 

Command Qualifiers 

/OWNER :ddnn: 
/PRIORITY :n 
/RATE : n 

Command Qualifiers 

/OWNER :ddnn: 
ALL 

Specifies the terminal or other device from which the tasks 
displayed are being run. You can name any device, pseudo device, 
logical device name, or terminal number for this argument. The 
default argument is ALL, which displays tasks owned by all 
devices on the system. 
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You can change the owner displayed by pressing ESC and entering a 
new device name. 

Note that this qualifier differs from other "owner" qualifiers in 
DCL in that it names a terminal and not a UIC as the owner. 



/PRIORITY :n 



Specifies the highest priority to be displayed. The default is 
250, the highest priority on the system. 

Use this qualifier to shorten the display to within one screen's 
worth. 

You can change this value by pressing ESC and entering a new 
priority. 

/RATE:n 

The /RATE qualifier allows you to set the rate at which the RMD 
display screen is to be replotted on the first display, n is the 
number of seconds between replots. The default n is 1. You can 
change the rate once the display begins by pressing the ESC key 
and entering a new rate. The rate setting returns to 1 as soon 
as you change pages. If you wish a slower rate, you must reset 
the rate each time you change the page. 

Use this qualifier to slow down the display. 

The Active Task List may change more often than once per second, 
but once per second is the most rapid rate available. 

Example 

>SH0W TASKS/ACTIVE/DYNAMIC 
The screen is cleared and the following display appears: 



RSX-11M V4.1 EL33 


512K 


OWN; 


= ALL 






14--N 


OV-8 


Name 


Length 


TI 


Pri 


1/0 


Stat 


us fl 


33S 






LDR. . . 


00002500 


COO 


248. 


0. • 


-CHK 


FXH 


STP 


-PMD 


PRV 


RMDEMO 


00026700 


TT0 


225. 


0. 


--CHK 


WFR 


-PHD 


PRV 


MCR 


SH0H0 


00026700 


HT0 


225. 


0. ■ 


-CHK 


-PMD 


PRV 


MCR 




NETACP 


00025500 


CD0 


200. 


0. 


STP 


ACP 


-PHD 


PRV 


NSD 


EVP... 


00014200 


COO 


199. 


0. 


3TP 


-PMD 


PRV 






DCLT5 


00035600 


TT5 


160. 


0. 


-CHK 


STP 


REM 


PRV 


CLI 


HB0FCP 


00044000 


COO 


149. 


0. • 


-CHK 


STP 


ACP 


-PMD 


PRV 


LPO 


00014100 


COO 


70. 


0. 


STP 


PRY 


SLA' 






TT5 


00002600 


TT5 


50. 


1. 


-CHK 


WFR 


-PMD 


REM 


MCR 



NSD 



NSD 



The screen changes once per second and displays the Active Task 
List. The first line identifies the operating system, version 
number, base level, memory size, the current owner of the tasks 
being displayed, and the date and time. Since the current owner 
is ALL, the remainder of the display is the Active Task List 
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itself. The display includes the task name, its length in octal 
bytes, its running priority, outstanding I/O count, and the 
status flags for each task. (See Table 7-2 for an explanation of 
the status flags.) 

>SHOW TASKS/ACT I VE/DYN AM I C/OWNER ! TT5 t 

The screen is cleared and the following display appears: 

RSX-ilM V4.1 BL33 512K 0UN=TT5S 21-N0V-82 14t57:i9 

Name Length TI Pri I/O Status flags 

SHOTS 00026700 TT5 0. CHK -PMD REM PRV MCR 

This example displays the Active Task List for a single terminal. 
The only task active at the terminal is the SHOW command itself. 



Notes 



The RMD display is in order of priority. When a new task comes 
in, all tasks below it in priority are displaced on the screen. 

See Section 8.1.9 for more information on RMD. 



7.12.3.4 SHOW TASK/LOGICAL_UNITS 

SHOW TASK:taskname/LOGICAL_UNITS displays the static 
logical-unit-number assignments (LUNs) for an installed task. 

Format 

SHOW TASK:taskname/LOGICAL_UNITS 

Argument 

taskname 

Specifies the task for which you want LUN assignments displayed. 
This must be the name of a task installed through INSTALL, and 
not through the install-run-remove form of RUN. 

The display consists of a list of physical devices and 

corresponding static LUN assignments. The display does not show 

any dynamic LUN assignments, even when the specified task is 
running. 

Tasks installed through the install-run-remove form of RUN do not 
have any static LUN assignments. 
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Examples 



>show task;teuksy/logical_units 
dbi: l. 
dbi: 2. 
dbi: 3, 

DB1S 4, 
T I ! 5 . 
CLOJ 6, 

This example shows the display. 

>SHOW TASKS TT7/L0GICAL 
SHO --- Task not in system 

This example shows the error message received when you attempt to 
show the LUNs of a task installed through the install-run-remove 
form of RUN. 

Notes 

You can display information about a terminal's logical 
assignments with SHOW ASSIGNMENTS, Section 5.10.1. 

You can display information about the LUNs of a task installed 
with the install-run-remove form of the RUN command with the SHOW 
TASKS/DYNAMIC command. See Section 7.12.6. 

SHOW TASK/LOGICALJJNITS is the equivalent of the MCR LUN command. 

For more information on logical units, see Chapter 5. See also 
the RSX-11M/M-PLUS Task Builder Manual . 

Tasks can dynamically alter their LUN assignments through the 
ALUN$ Executive directive. 

Error Messages 

SHO — No LUNS 

Explanation: Informational message. The task did not have any 
logical units. 

User Action: None. 

SHO — Task not in system 

Explanation: Informational message. Command specified a task 
that is not in the system, or that was installed by means of the 
install-run-remove form of RUN. 

User Action: SHOW ASSIGNMENTS displays logical device 
assignments for your terminal. SHOW TASKS/DYNAMIC can display 
LUN assignments for tasks installed with the install-run-remove 

form of RUN. 
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7.12.4 SET PRIORITY 

SET PRIORITY alters the priority of an active task. 

This is a privileged command. 

Format 

SET PRIORITY 

Priority? pnum 

Task? taskname 

SET PRIORITYm taskname 

Parameters 

pnum 

Specifies the new priority you wish to assign to the task. 
Priority numbers are in the range of from 1 through 250. n is 
octal or decimal. You must add a decimal point to decimal 
numbers. 



taskname 



Specifies the name of the active task whose priority you wish to 
alter. 



Example 



>sh0u task!tt7/full/active 

11/ 066734 gen 064244 01676500-02062100 pri - 50, dpri - 50. 

status: -chk ufr -pmd rem mcr 

ti - tt7j ioc - 1, eflg - 000000 040000 ps-70004 pc--072132 

REGS 0-6 041130 051172 000000 000040 010400 051520 001472 
>SET PRIORITY 
TASK? TT7 
PRIORITY? 199 
SET -- Syntax error 



>set priority tt7 199. 

>sh0u tas act ful tt7 

tt7 066734 gem 064244 01676500-02062100 pri - 199, dpri - 199. 

status: -chk ufr -pmd rem mcr 

ti - tt7: ioc - 1. eflg - 000000 040000 ps-70004 pc-072132 

REGS 0-6 041130 051172 000000 000040 010400 051520 001472 

>SET PRIORITY TT7 225 

>SH0U TAS ACT FULL TT7 

TT7 066734 GEN 064244 01676500-02062100 PRI - 149. DPRI - 149. 
STATUS: -CHK WFR -PMD REM MCR 

TI - TT7! IOC - 1. EFLG - 000000 040000 PS-70004 PC-072132 
REGS 0-6 041130 051172 000000 000040 010400 051520 001472 

This example shows the effects of SET PRIORITY. The user first 
displayed the priority of task TT7 with SHOW TASKS/FULL/ACTIVE. 
The user then issued SET PRIORITY to change the task's priority 
to 199 but did not terminate the priority number with a decimal 
point. The system rejected the command because it recognized 
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that a number containing a 9 was not an octal number. The user 
then issued the command with the decimal point and it was 
processed. The user then attempted to change the task's priority 
to 255, again omitting the decimal point. This time the command 
was processed without an error message, but the priority was 
changed to 255 octal, which is 149 decimal. 



Notes 



Notice that SET PRIORITY changes both the running and default 
priority of a task. A task can change its own priority through 
the ALTP$ Executive directive. With this directive, only the 
running priority is changed. 

SET PRIORITY is the equivalent of the MCR ALT command. 

There is no SHOW PRIORITY command. You must use SHOW TASKS 
instead. 



7.12.5 SHOW /CLOCK_QUEUE 

SHOW /CLOCK_QUEUE displays information about tasks currently in the 
clock queue. The information consists of the task names, the next 
time each task is to be run, and each task's reschedule interval, if 
one was specified. 

Format 

SHOW /CLOCK_QUEUE 

Example 

>SH0W /CLOCK-QUEUE 

LIONEL SCHEDULED AT 29-0CT-82 17 1 41 t 31 1 51 RESCHEDULE INTERVAL 05 SECS 

ONEUP SCHEDULED AT 29--0CT--B2 17 J 48! 44 I 05 

CALDOR SCHEDULED AT 29--0CT-82 18:00t00!00 RESCHEDULE INTERVAL 02 HOURS 

TEWKSY SCHEDULED AT 30-0CT-82 10;00:00:00 

This example shows the display from SHOW /CLOCK_QUEUE. Installed 
tasks are placed in the clock queue through the scheduling 
options of the RUN command. See Section 7.2.2. 

The task LIONEL is scheduled to run at 17:41:31:51 (hours, 
minutes, seconds, ticks) and every 5 seconds thereafter. 

The task ONEUP is scheduled to run at 17:48:44:05. 

The task CALDOR is scheduled to run at 18:00:00:00 and every two 
hours thereafter. 

The task TEWKSY is scheduled to run at 10:00:00:00 on the next 
day. 

Notes 

SHOW /CLOCK_QUEUE is the equivalent of the MCR CLQ command. 

Installed tasks are placed in the clock queue through the 
privileged form of the RUN command. See Section 7.2.2. 
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This command has nothing to do with queues under the control of 
the Queue Manager. Entries in Queue Manager queues are displayed 
through SHOW QUEUE. See the RSX-11M-PLUS Batch and Queue 
Operations Manual. 



7.12 .6- SHOW COMMON .'"."" J ' , ' ; - - ' . ' 7- . : 7^''T.. ■■ ' ■ ' 

SHOW COMMON displays the names of resident commons installed in the 
system, their PCB addresses, the number of attached tasks, and the 
status of the common. This command is for RSX-11M-PLUS systems only, 

¥o"u can also display information about a single common, optionally 
including a list of tasks attached to the common 1 . 

Format : ■ h - >-,„"' ■ _ ■ ' _ • ' . . - : . ■ .. 

SHOW COMMON [ t commonname] [/qua 1 i r ior J 

"/ ■ . Command ' Qual i f ier , ' - " " ; * ■ " _ ■ _ " * . : . - ' 

;:- /task r:i-''': : 7. : -l. ;// v*,'' ;; \. ;U„ ;/ r '"'^7--, ."4 ! ?:/. : ■■■;■„ ".'"": .'■■■■■ ■ " :,;: ^'■■; 

Arg um en t " [: ""[ ■ -,/" ■ ' : -, : . ■ ■ ; "■ ,, : . " i '"'- : ' , ,;, , : ■■ ■ • '".'.,_ " ■■ ■ '". ■ 

If you do not name a common, information about all commons in tli«? 
Common Block Directory is displayed. 

The display is in the following format; 

commonname pebaddr taskcount statusbits 

In. this display, commonname is the name of the common, pebaddr is 
the address of the Partition Control Block (PCR) , taskcount is 
the number of tasks mapped to the common, and statusbits is a 
list o£ common region status bits that are set. Here is 3 list 
';' ;: '■* \,^ :: "of 7 statusbits and their meani ng s : " -' ■ "'"/ >> " ' ,,. _ : . . ";"^ ■■■■•■. : "'"'' ;; '" ; . : "" _ " ■■■,::,,,' ; 



Status Bit 

/ ■'■ CAP 

-CHK 

CKP 

CKR 

COM 
.DEL 

DRV "" 

■ FXD 

LIO 

LPR 

NSF 

OUT 

PER 

PIC 

RON 



'" : .-"■' .l '"?".' .."'• Meaning '".■'' ■ ■ .m,,,-'" - " ■ •' 

Checkpoint allocation failure 

Hoc c h e c k po i n t a b 1 e 

Checkpoint in progress 

C h e c k po i r s t r e q u e s t ed 

Library or common 

Marked for delete on lar-t detach 



V>>Mil*JUi V *.*■ : 



Fixed in memory 
Long I/O 
Last load failed 
Not shuffleable 
Out of memory 
Parity error 
Position independent 
Read-only common 



Usually, the status bits will indicate that the common region is 
either fixed in memory (FXD) or out of memory (OUT). 
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commonname 

Specifies a common name about which information is to be 
displayed . 

Command Qualifier 

/TASK 

Specifies that you wish a list of tasks attached to a particular 
common region showing the number of times each task is mapped to 
the common (mapping count) . 

Examples 

> SHOW COMMON 



BASIC2 


050644 





status: 


COM 




DEPRES 


056340 





STATUS', 


COM 




DSMBUF 


053630 


5 : 


status: 


COM 


P I C 


DSMSUP 


064164 


*y 


status: 


COM 




FCSFSL 


117210 


I", 


' status: 


COM 




TTCQM 


034620 


1 


status: 


F.Xl'i 


C OH 



This example shows the display from :the unadorned SHOW COMMON 
command. Currently, six commons are installed in the system. 

>SH0 comm: DSMBUF 

DSMBUF 053630 5 STATUS? COM PTC 

This example shows the display when a single common is named. 

>SH0 COM! DSMBUF TASK 

DSMBUF 053630 5 STATUS: COM PH.: 

DSMIO 3 

DSMGAR 1 

DSMT61 1 

This example shows the display when a list of tasks is requested 
for a single common. 

Notes 

SHOW COMMON is the equivalent of the MCR CBD command. 
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CHAPTER 8 
SYSTEM CONTROL 



The commands in this chapter are used to control and display certain 
system level functions. The SHOW commands in this chapter are 
nonprivileged, but all other commands in the chapter are privileged. 
Other commands needed for system control may be found in other 
chapters of this manual, in the RSX-11M/M-PLUS MCR Operations Manual , 
and in the RSX-11M/M-PLUS System Management Guide. 



8.1 SET AND SHOW 

You can set and display the time and date, the system and library 

UFDs , and the size of the dynamic storage region (pool). You can 

display the logged-in users and the current use of memory on the 
system, and you can enable and disable logins to the system. 



8.1.1 SET DAYTIME 

SET [DAY] TIME sets the current date and time. 

Format 

SET [DAY] TIME [date] [time] 

Parameters 

Either the time or the date, or both, can be specified in the 
command. They can be specified in either order. If you do not 
specify a time or a date, you will be prompted. 



The date field and the time field must be separated by a space. 



date 



Specifies the date. You can enter the date in 

formats: 



either of two 



dd-mmm-yy Where dd is the number of the day, mmm is the 
first three characters of the name of the 
month, and yy is the number of the year 
(relative to 1900) . 

mn/dd/yy Where mn is the number of the month, dd is the 
number of the day, and yy is the number of the 
year (relative to 1900) . 

Regardless of the format you choose, the date is displayed in the 
first format. 
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time 

Specifies the time. Time is entered in the following format: 

hh:mm[:ss] Where hh is the number of the hour in the 
24-hour format and mm is the number of the 
minute, ss defaults to 00. 

Examples 

>SET TIME 
Time? 8! 05 

This example sets the time at 8:05 on the current day. 

>SET DAY 

Date? 16-JAN--66 

This example sets the date at January 16, 1966. The time setting 
is unchanged. 

>SET DAY 

Date'!' 01/14/63 17: 14 

This example sets the date at January 14, 1963, and the time at 
17:14:00. The date will not be displayed in the format entered 
but as 14-JAN-63. 

>SET DAYTIME 0A--JUN-44 04 100 100 

>SET TIME 04; 001 00 06--JUN-44 

The examples are equivalent. Both set the date at June 6, 1944, 
and the time at 04:00 hours. 



Regardless of the prompt, you can enter the date or time in 
either order. 



8.1.2 SHOW [DAY] TIME 

SHOW [DAY] TIME displays the current time and date. The time is in 
24-hour format and the date is formatted as dd-mmm-yy. 



Format 



SHOW [DAY] TIME 
SHOW TIME 
SHOW DAY 



Example 



>SH0U TIME 
04:00:22 06-JUN-44 
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8.1.3 SET SYSTEM 

SET SYSTEM establishes certain characteristics of the system. It is a 
privileged command. 

Format 

SET SYSTEM [/qualifier] 

Command Qualifiers 

/EXTENSION_LIMIT:n 
/[NO] LOGINS 
/PACKETS :n 
/POOL: top: max : total 
/DIRECTORY: [g,m] 

Command Qualifiers 

/EXTENSION_LIMIT:n 

The /EXTENSION_LIMIT qualifier establishes the maximum size to 
which a task can extend itself by means of the EXTEND TASK 
directive, n can be entered in all the formats used in the SET 
PARTITION command. See Section 7.12.1. 

See the RSX-11M/M-PLUS Task Builder Manual and the RSX-11M/M-PLUS 
Executive Reference Manual for more information on the Extend 
Task directive. 

/[NO] LOGINS 

/[NO]LOGINS enables or disables logins. 

If you issue SET SYSTEM/NOLOGINS and then log out, you will have 
to reboot the system to log in again unless there is another 
privileged user logged in. 

/PACKETS :n 

The /PACKETS qualifier specifies the maximum number of I/O 
packets to be retained in a separate queue for use by the QIO 
directive. Changing the number of retained packets helps 
optimize the servicing of QIO requests. n can be from through 
15. The default is 5. 

This value is a system-generation option on RSX-11M systems. 

On RSX-11M-PLUS systems, the value is usually set as a part of 
the' startup procedure. 

This command is equivalent to the SET /MAXPKT command in MCR and 
VMR. 

SHOW SYSTEM/PACKETS displays this limit and also the number of 
packets currently available. See Section 8.1.4. 
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/POOL: top 

The /POOL qualifier increases the size of the system pool (the 
dynamic storage region) . The top argument is the number of 
32-word blocks (decimal) . The max argument is the maximum size 
in decimal words. The total argument is the total size in 

decimal words. 

/DIRECTORY: [g,m] 

/DIRECTORY establishes the identity of the system directory. The 
UFD you name must already exist. This command does not create a 
UFD. 

/DIRECTORY is the default qualifier for SET SYSTEM. 

See the discussion in Section 8.1.5 for information on the use of 
this command on RSX-11M and RSX-11M-PLUS systems. 



Examples 



>SET SYSTEK 

System UFD? L3j54.] 



>SET SYSTEM 113.54] 

These commands are equivalent. They establish the system 
director^ as UFD i*3 54^ on oseudo device LB? -. 

>SET SYSTEM/EXTENSION.J-IMIT! 1200 

This command sets the maximum size to which a task can extend 
itself through the Extend Task directive to 1200 (octal) 32-word 
blocks (decimal) or 30K words. 



8.1.4 SET LlBKAKY/DiKECTORY 

The SET LIBRARY/DIRECTORY command establishes the library UFD on 
RSX-11M-PLUS systems. 

See the discussion in Section 8.1.5 for the. relation between SET 
LIBRARY/DIRECTORY and SET SYSTEM/DIRECTORY. 

Format ;\ : . ■.'■,■,/"'■ '^ A ;„ : ' %...' -■■■"■i '•"" 

' SET LIBRARY/DIRECTORY: [g,m] • ■',:„:_. ;,:;,,, :''■■ ■ 

This command ostsciishes tho identity O^" the system librarv UKD 
on an RSX-11M-PLUS system. The command does not create a 
directory. The directory must exist before you issue the 

:/ command. :'.'.. ' - .... .■ ...... ■■- ■■ : , ,." i " :: ' '■■■■ ,:■:,.-".. 
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8.1.5 SYSTEM AND LIBRARY UFDS 

On RSX-11M systems, the system image flleand all system tasks and 
utilities are kept in the system directory on pseudo device LB:. You 
can display the current setting for this directory with the SHOW 
SYSTEM/DIRECTORY command. Privileged users can change the directory 
with the SET SYSTEM/DIRECTORY command. 

when you issue a HUN or INSTALL command and precede the filespec (that 
is, the task image file name) with a dollar sign ($) , you are 
instructing the system that the task you wish to run or install is in 
this di rectory. 

On RSX-liM-PLUS systems, the system image file and all privileged 

system tapks are kept in the system directory on pseudo device LB', 
You can display the [JFD with the SHOW SYSTEM/DIRECTORY command. 
Privileged users can change the UFD with the SET SYSTEM/DIRECTORY 
command. All nonpr ivileged system tasks and utilities are kept in the 
library UFD on pseudo device LB;, You can display the current sotting 
for this directory with the SHOW LIBRARY/DIRECTORY command. 
Privileged users can change the directory with the SET 
LIBRARY/DIRECTORY command , 

When you issue a RON or INSTALL command and precede the filespec (the 
task image file name) with a dollar sign ($) , you art.- instructing the 
system that the task you wish to ran or install is in one of these 
directories. The system directory If, searched first and then the 

library directory. ■■ , ' ",/"; ■ >■■> :.,. ;,/""'"' ' /., V.J.; > ■''//"'. !i ."■■■,.''. "! ;.' ''"'■" ^ 



8.1.6 SHOW SYSTEM 

SHOW SYSTEM displays information about the current system. 

Format 

SHOW SYSTEM [/qualifier] 

Command Qualifiers 

/CLI 

/DIRECTORY 

/EXTENSION_LIMIT 

/PACKETS 

/POOL 

/SECOND ARY_POOL 

Command Qualifiers 

/CLI 

SHOW SYSTEM/CLI displays information about each command line 
interpreter (CLI) on the system. The information includes the 
name of the CLI, the name of the task that implements the CLI, 
the number of terminals set to the CLI, and several status flags 
for the CLI. 
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Here are the status flags: 

ACT CLI is active. 

DSB CLI is disabled. 

PRV CLI is available to privileged users only. 

RST CLI is restricted. 

For more information about adding CLIs to the system, see the 
RSX-11M/M-PLUS MCR Operations Manual and the RSX-11M/M-PLUS 
System Management Guide . 

There is no SET SYSTEM/CLI command in DCL. 

/DIRECTORY 

SHOW SYSTEM/DIRECTORY displays the current system directory. The 
display specifies SYSUIC, but the system directory rarely has a 
UIC associated with it; it is a UFD. SHOW LIBRARY/DlKKCrORS 

displays 'the current library directory. See Section 8.1.5 for 
more information. 

/EXTENSION_LIMIT 

The SHOW SYSTEM/EXTENSION_LIMIT command displays the maximum size 
to which a task can extend itself by means of the Extend Task 
system directive. The size is displayed as an octal number of 
32-word blocks (decimal) . 

/PACKETS 

Normally, some number of 18-word I/O packets are set aside in 
pool and retained in a separate queue for use by the QIO 
directive. This number of packets (referred to as MAXPKT) is 
used to optimize the servicing of QIO requests. 

The SHOW SYSTEM/PACKETS command displays the maximum number and 
the current number of available I/O packets in the format: 

MAXPKT=m, :c, 

where m is the maximum number of and c is the current number of 
available I/O packets. 



/POOL 



The SHOW SYSTEM/POOL command displays the current status of the 
system dynamic pool as three numbers, flor: lfb: tps, where 
flor is the first location available for user partitions, lfb is 
the largest free block in decimal words, and tps is the total 
pool space in decimal words. 

The SHOW MEMORY command (Section 8.1.9) displays considerably 
more information about the pool. 
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SHOW USERS 



/SECONDARY_POOL ' . '■■-■■ 

The SHOW SYSTEM/SECONDARY POOL command on RSX-11M-PLUS sySi.rtm.---5 
displays informal.', on obout secondary pool. Tne display is in the 
following format: ■ "■., ■" .■ , >- V": ■■■■,. ""-"■■ ...„■,:,■■'"„ ""■ ' 

: ■'■". ! ; :: " ;':■• SivCPOi.^f :ree:s i ze;pct /„:,,:"" ./ ' '■,■,; "": ;; ' ; ' :j >>""li .' : - TL'. : '- : ; .'. ■™:l,' : ' v ' : '' : 

where Eree is the amount of" tree secondary pool in 32-word 
blocks, size is the size of secondary pool in 32-word blocks, and 
pet is the percentage of fret- blocks in secondary pool. 



3.1.7 SHOW LIBRARY ,,', "/""J , ■'",",; h ,,,,, ','. _ - • ,,1,'"", '''-• - : y* 

The SHOW LIBRARY command displays the current library directory on 
i'SX-llM-PLUS systems. The display speqi'f ies LIB'JIC, bi.e the Ubrar-y 
directory rarely has a UIC associated witij i t ; i\ is a OFD. 



8.1.8 SHOW USERS 

SHOW USERS on RSX-11M systems displays the terminal number and, login 
UIC for all logged-in users. 

SHOW USERS on RSX-11M-PLUS systems displays the terminal number, login 
UIC, :..od default UFD for -all Logged-in users. If Resource Accounting 
is supported and is running, SHOW USERS on RSX-1.S.M-PLUS also shows the 
date and time of login, the number of tasks active on the terminal, 
and the user name of the person logged in. 

Format 

SHOW USERS 

Examples 

>SHOW USERS 

TTO: [3,541 

TT22 [7,40.1 

TT5: C303 ,370 3 

TT?: C200.1j 

TT165 [7,42j 

TT51: L7,2£3 

TT54: [303, 53 

HT2I [7,43J 

This example shows the SHOW USERS display for an RSX-11M system. 
The first column identifies the terminal. The second column is 
the login UIC for nonprivileged users and the current UIC for 
nonprivileged users. HT2: is a DECnet host terminal. 



8-7 



SYSTEM CONTROL 



SHOW USERS (Cont.) 



SHOW USERS 



r t 2 : 
r r s : 

TT7 5 
TF16: 

ttjo: 
nai : 

T T 5 4 5 

H • „> i 



i 7', 4:03 
[301.3703 
[20< • 13 
■C 7*423 
[200.20 3 
C 1 r 2 3 . 
[1,10 3 
L 7 - -13 J 



[7,403' . 

L301 »/r» i 

C 2 00.. 13 
[7,42;) 

[ 7,37 3 '■■" 

[7,2o 1 

r -<'o ,-.,'..; i 



This example shows l;he SHOW USERS display for an RSX-11M-PLUS 
system without Resource Accounting active. The first column 
identifies the terminal. The second column is the defaull OFD. 
Column 3 is the lo-un UIC, HT2: is a DtCnet hogt iierm.ifi'al''": 



LhOK USERS 

TT7 5 117,40 3 

TTIO: [303,5 3 

TT14 5 [7,25 3 

TT15 5 Clfl3 

TT165 [314,3623 

TT17 5" C7f 603 

TT20J C12fl0D 

TT215 CI. 63 
TT27 5 ; "• [303.23 

TT30 5 [303,103 

TT32t [301,113 

TT/?!x: r? t i fti 

TT345 111.24: 

TT35 5 1301.3703 

TT36! E7.3023 

TT375 [303,143 

TT415 [303,12.3 

TT425 E304.3253 

TT43 5 [303.23 3 

TT455 C7.43J 
TT465 ; 17,613 

, I F47 « C3I 4 . 362 i 

TT505 [301,3563 

TTSi: [304,273 

VT3 5 [303,53 



C7.403 

[7,1003 

C7.253 

[7,503 

C7. 143 

[7,603 

[ 7 . 2-4 3 

C7.133 

I 30 3 .23 

[303.103 

E7. 113 

E7 » 1 6'3 

L7.213 

C301..3703 

[7.3023 

[303.143 

[303.123 



C7 



151 



[303.233 
[7.433 

[7.103 
[7. 3623 
[301 .356 3 
[304.27 3 
[303,5 3 



This example gives the SHOW USERS 
system with Resource Accounting. 
■user ' s TI : , the second column is 
third column is i.h« Login UIC, 
and time of login, the fifth co 
currently active-, and the -six 
Resource Aeountiing is not active 
the Last three columns are not d 
the example logged in when Re sour 



7- NOV- 82 10157 

7--N0V-82 115 10 

7-NQV--82 13:56 

7-N0V-82 Ilt06 



N 00-82 
'NCjV-82 
NO 0-82 
NOV -82 
N0V--82 
NOV -82 ■ 
NOV- 8 2 
NOV-82 
■NOV-82 
■NOV -82 
NOV-82 
•NOV-82 
NOV-82 
NOV-82 
NOV-82 
■NOV-82 

■NQV — 32';.'i 

-NOV-82 
NOV-82 
■NOV-82 



litis 

10 : t47 :i 
10 550 
12155 
12 533 
1 4 J 1 4 
10556 
11508 
12136 
10 555 
13501 
12 5 36 
10 J 56 
1 1 : 17 
14 5 35 
10 5 53 
1 '5 : :5 03 
11507 
10 5 59 
155 04 




1 ' 


o 
:i. 
o 
■o 
i 








1 



A 


GR0UPE 


U)v. 


WRITERS 


M. 


FOX 


■$%■:. 


CALDWELL 


B. 


AhltEK " : "'" 


F-, 


LIEBERWIRTH 


D> 


BROUN 


B. 


MABRY 


L. 


SWEENEY 


J, 


PAINTER 


',!«'■ 


KASS0N 


E. 


3AAT2 


A. 


BODGE -' 


O*'*:! 


ADAMS 


J. 


KORAN 


c. 


FOOT EC OLE 


p* 


BEZEREBT 


J . 


PETERSON 


J. 


KAUFFMAN 


E. 


POLL ACh 


ri ,; 


': aTiI'tA U £"■ i"l 11 
IIOIVMU^J U IV 


J . 


THOrtF'SUN 


D, 


CARHAN 


T, 


PARMENTER 



display for an RSX-11M-PLUS 

The- first column identifies the 

the current default OFD, the 

the Eo'uxth .-■*,] i,"i gi^e-s the tete 
lumn is the number of ' "tasks 
th col urn -i is the user name. If 
or running at the rim? of login, 
Lsplayed. The user on TT16: in 
ce Accounting was not active. 
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8.1.9 SHOW MEMORY 

SHOW MEMORY invokes the Resource Monitoring Display (RMD) , a system 
utility program. This program displays in a graphic manner the status 
of much of the system. It is, in effect, a display of the contents of 
the system pool {dynamic storage region) . 

The RMD program is useful for monitoring the general activity of the 
system. It is also useful viewing for a new user to see how the 
operating system operates. However, you should understand that the 
graphic display is approximate and cannot be used for critical 
measurement. 

Format 

SHOW MEMORY 
Example 

>SH0U MEMORY 



The following example shows the SHOW MEMORY display for 

The circled numbers are keyed to the explanation. 



RSX-11M. 



RSX-11H V4.0 BL32, 
© TASK= *IDLE* 

© P00t=i 686 , : 3168 . J 5.5". 
1686. J3168.J55. 



(QUASAR) 512K 

Q FRE£= SYO! 18470. 
- ."'"■'■ . DB1 J 62322. 




LFRQ . 

POMM . 

lODG . 

LE A 

M. T 

, . 



f -R 
. M 
. B 
C T 
A 5 
. 4 



12-MAR-81, 10 J 591 16 



DB2J1454J 

de3:dmo 



© 



0*******32******64******?6****** 128*****1 60*****1 92*****224***** 
256*****288*****320*****352*****384*****416*****448*****480***** 



© 



PARS 

CEXPAR 

TTPAR 

DIRCOM 

SYSPAR 

TKNPAR 

DRVPAR 

LBRPAR 

BASIC2 

FCSRES 

TSTPAR 

GEN 



JC 

:t 

JC 

:t 

1 T 

:d 
;t 
jc 

JC 
JT 
!D 



© 



<D 



ERRSEG 
6. 



The following example shows the SHOW MEMORY display for 
RSX-11M-PL0S. The c<rcle<3 numbers are keyed to the explanation. 
Some numbers appear on the RSX-11M-PLUS ..example only. 
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o 



RSX- 'it; , ( US V.' B! IX) 
© TASK= F'IPHI 

© POOI ' S 70, t i.484, $74. 
170.:i4H4. 







© 



O 



(CASTOR) il2K >.' 000$00t49 6-BEC-81 

$ ( r.t i si ;> : i-h^A . »Bi $ r«KO 
DB0J8755 mztmo 

© SECPOO! ^64, $256. $25% 
£4, J 256.! 255: 



i,( t'fir - -- a; bi-k f. fl . pr v?*- 

DORS! rOYZ ■'si!', 4H ;1^ ! iX 

$:t$f :osi c n bh dh ..s 

O LLv 1 V*V i:A Vv PNV 
M Oil 1*3 MC 64 CSS 

Gl 0* OF LPL 

,,.. . ..'. >>>>!>>»■ >+-»-»->! !- 

^ E _ J__p__ D _- .£, -_p_D__. _D~— ; „.„_-____— -' 

256***#*288^****320*****;J52*****3H4*^^^ 



in: \ 


M !i B 


28 I 


c : « 


215K \ 


R R 


out: / 


• . "I 7 


» 


" ■ ■, i f 


OK / 


'. Ml 




-,?;■> | [ __■; 



F 


LNNQ 


5 


A 


p 


i ■■i.l 


I 


p fem 


., 


T : 


" ': 


". .. 


1 


0. Ifj 


p 


.. 


D 


• 


A 


DA. 





V 


L 


a 


C 


LC. 




1 


• ■■> 


I 


! P 


, xi- . 







: " ■il*^ ■ 


: ' : >!i: 



•*;?=»!:+ 



->- !>-> — > 




+ 


'■ <->■-> 


-:: - 


T::T;™'«;i^ 


— 


■ PR A 


L 


pfl.lSKfflii 


E D 


R 


M .. 


P 


f N MM 1 





. 


D I 


M 


A ' 


I 


. n DD . 


: 6 


. 


T R 


I. 


i . 


P 


T F W V 


H 


E 


T H 


V 


r 


H 


3 S 71 1 





n 


3 1 


lj 


3 


1 


2 L 1 




T """ 


2 




3"" 





t^,;' 1 ".: •■? 



i nh s 




©v: 



I W.I II 



A Operating system type, version number, and base level. 

Q Six-character name that is a DECnet node name (if DEcnet is 

running on your system) or the system name that you 

splpcrt-.pr! in SYSGEN < i f DECnet is not running on your 
system) . 

Q Size in K words of the system memory. 

For RSX-11M-PLUS systems, time elapsed in units of days, 
hours, and minutes since the system was last booted. 

@ Current date and time. 

■£• isomer Ui luc Laorw LiiaL ±o »_.u j.. j. c:n i. x ^ caclulki^ yi , J. t uwuc a o 

executing, *IDLE* (Executive executing the idle loop). 

A Number of free blocks on four Files-11 devices in your 
system. If a device is dismounted, RMD displays "DM0." If 
a device is off line, RMD displays "OFL." 

@ Pool (dynamic storage region) information in the format: 

P00L=X:Y:Z 

X Number of words in the largest free block in pool 

Y Number of free words in pool 

Z Number of free words in pool 

The second line records the worst case of pool since you 
invoked RMD. This line is most useful if RMD has been 
running on a slaved terminal since the system was last 
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(D On RSX-ilM-PLUS systems, secondary pool information in the 

r ', : * J-* . format: 111-'"'. ■ ■ '" " ■">■■■■ ■ ', 

"''[' ;; : -J":'-': SKCP00L-A:3:C% '" ■";■'■'■■ '' L':,../^\: "■-'"'\, ; . i ;; ; ""'' ;■ ■,.,: ""■'; ■■■l-*i,,'""- :i, ;: : ; 

A Number of free blocks in secondary pool 

B Total number of blocks in secondary peel 

C$ Percentage of secondary pool that is free 

The second line records the worst case of secondary pool 
since you invoked HMD. This line is most useful if RMD has 
been running pn a slaved terminal since the system was last 

booted. .■,,:„.'■?■; ''■;-"";".„ * - 7 ! i::„,; i; ; ;' :ri! : ■: i".:,:,.;..,, ' : -; ;,: - !;i ;i : 'lc : :,:; : ,...' :---: r;,,:,,.,-:^ 5 ' ' l :i! «',.„ : '"'"- 7 : «,l 

flj) Partitions in the system using the format: 

part itionname: type 

type 

For RSX-L1M systems, one of the following: 

T Task partition 

S Subpartition 

D System-controlled (dynamic) partition 

'7 C ''Command' partition 

For RSX-11M-PLUS systems, one of the foil owing: 

D System-controlled (dynamic) partition 

P Secondary pool partition 

0) Number of tasks in memory and amount of memory they use and 
number of active tasks swapped or checkpointed out of 
memory and the amount of memory they would require. 

© Name of each task, common, or driver in memory and its 
location in memory using the following symbols to designate 
size, type (task, common, or driver), and other attributes: 

Symbol Attribute 

< > Active task 

t ] Task not active but occupies memory 

! ! Named common 

+ + Unnamed common (displayed name is first 
attached task) 

( ) Loaded driver using device mnemonic 

Task not fixed in memory 

===== Task fixed in memory 

The hyphens and equal signs represent the amount of memory 
that each task, driver, or common occupies. Where the 
display shows only one delimiter and no hyphens or equal 
signs, the open delimiter is in the same location as the 
closing delimiter of the preceding task. 
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© Partition size and location. The beginning of each 
partition is marked with the same symbols as those listed 
previously plus the following additions for both operating 
systems: 

E Executive 
P Pool 

The lines of asterisks are proportional representations of 
the amount of memory occupied by each partition. The 
numbers are in lK-word increments. Each numerical 
character also represents the same amount of memory as an 
asterisk. 

(D System error count sequence recorded by the Error Logger 
(always zero if Error Logger not present in your system) . 



Notes 



RMD must be installed under the name ...RMD for this command to 
work. 

RMD adjusts its display to your terminal model. If you are at a 
video terminal, the display changes as you watch it. If you are 
at a hard-copy terminal, a snapshot of the display as of the 
moment you issued the command is printed on your terminal. 

Often, RMD is set running on a slaved terminal near the computer 
as part of the system boot procedure. 

Task locations and sizes displayed by RMD should be considered 

approximate. RMD is primarily designed to provide a visual 

display and system debugging tool. It does not measure task size 
or location accurately. 

In general, RMD is designed to allow either an operator or user 
to view the current state of the operating system. The 
information is presented in a graphic, easily comprehensible 
f o r m . 

There are a number of specific instances in which RMD can help to 
locate certain system lockout problems or bugs in application 
and/or system-level software: 

• Bugs and other situations that cause exhaustion of system 
dynamic memory (resulting in unexplained system hangs) 
may be detected and more easily reproduced and diagnosed. 

• Task checkpointing and swapping can be monitored and, in 
systems with limited memory, deadlock conditions can 
often be diagnosed more easily. 

• Free space on a number of Files-11 devices may be 
monitored in real time, which may help in situations 
where on-line storage is at a premium or where some 
program is running wild. 
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SHOW MEMORY (Con!.) 



Other pages in the RMD display are invoked by the SHOW 
TASKS/DYNAMIC command (Section 7.12.3.3). Once you have started 
the RMD display by either SHOW TASKS or SHOW MEMORY, you can move 
from page to page without issuing any more DCL commands. In 
fact, RMD is meant to enable you to watch the activity in memory, 
on the active task list, and within a single task header and to 
note the relation between these pages. See the RSX-11M/M-PLUS 
System Management Guide for a full explanation 61: all the 
functions of RMD and for descriptions of the commands used within 
RMD to change from page to page. 



3-13 



CHAPTER 9 
QUICK REFERENCE 



This chapter lists all DCL commands in alphabetical order. Each 
command entry includes cross-references to the full command 
description in this manual or to other RSX-11M/M-PLUS manuals. Each 
command entry also includes a general description of the functions of 
the command, as well as the full command syntax, sometimes with brief 
comments behind an exclamation point (!). 

These command descriptions are intended for quick reference only. If 
you are not familiar with the functions of a particular command, you 
should read the main text referenced in this chapter. The comments 
are in shorthand form and are meant to serve as reminders only. 

Comments include examples of input, value ranges, and cautions. 
Privileged commands and qualifiers are flagged as are commands 
available on RSX-ll.M-PLUS anly. A number of commands have two 
qualifiers listed as synonyms. Other qualifiers perform no operation 
by themselves and are listed in the comments as "no-ops." These 
synonyms and no-ops are usually included for compatibility with DCL on 
VAX/VMS systems or for clarity and completeness. See the main text 
for more information. 

This chapter does not document the differences between DCL commands as 
used interactively and DCL commands as used in RSX-11M-PLUS batch 
processing. Nor does it provide descriptions of the batch-exclusive 
commands, which are not part of the DCL command set. See the 
RSX-11M/M-PLUS Batch and Queue Operations Manual for descriptions of 
these commands. This chapter also lists and summarizes the DCL 
commands used in setting up the Queue Manager. The RSX-11M/M-PLUS 
System Management Guide includes full details on using these commands. 

For your convenience, some frequently used commands have brief forms. 
These short forms are not necessarily compatible with other 
implementations of DCL and are provided for the convenience of 
RSX-11M/M-PLUS users. They are: 



ABORT 



H 



HELP 



B 


BROADCAST 


? 


HELP 


C 


COPY 


LO 


LOGOUT 


D 


DIRECTORY 


L 


LINK 


DEA 


DEALLOCATE 


M 


MACRO 


DEAS 


DEASSIGN 


P 


PRINT 


E 


EDIT 


R 


RUN 


F 


FORTRAN 


S 


SHOW 
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ABORT Section 7.3 



ABORT forces an orderly end to a running task or to the action of a 
specific command. Nonprivileged users can abort any task running on 
TI:. Privileged users on RSX-11M-PLUS can abort any task by using the 
/TKRM1HA1. qualifier. . . ■ ' ■ 



ABORT [/COMMAND] [/qual i f ier [ s] ] commandname 

ABORT/TASK t/qual if ier] taskname 

Command Qualifiers 

/COMMAND "Default 

/TASK 

/TERMINAL:ttnn: ! Privileged; RSX-11M-P1.DS only 

/[NO] POSTMORTEM 



ALLOCATE Section 5.4 



ALLOCATE declares a specified device to be a private device. If you 
omit the unit number and colon, the first available device of that 
class is allocated. 



ALLOCATE [/qualifier [s] ] dd[nn:] [logicalname] ILogical names same as 

lother device names: 
! Two characters, octal 
iunit number, and :. 

Command Qualifier 

/TERMINAL: ttnn: [Privileged 

IRPflfi. RJfnR- RT.m . and so nn. 



APPEND Section 4.4.3 



APPEND appends to an existing sequential file records from one or more 
sequential files. 



APPEND [/qualif ier [s] ] infile[,s] outfile 

Command Qualifiers 

/DATE:dd-mmm-yy -Given day only 

/SINCE :dd-mmm-yy !From given day through current day 

/THROUGH :dd-mmm-yy !From beginning through given day 

/SINCE :dd-mmm-yy/THROUGH:dd-mmm-yy IFrom given day through given day 

/TODAY ! Today only 

/EXCLUDE: filespec JFilespec can include wildcards. 
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ASSIGN 



Section 5.2 



ASSIGN associates a logical name with a physical device, pseudo 
device, or other logical device. All references to the logical name 
are resolved by the system to the associated physical device, pseudo 
device, or logical device. See also other forms of the ASSIGN command 
described in the following entries. 



ASSIGN[/qualif ier [s] ] ddnn: logicalddnn: 



Command Qualifiers 

/LOCAL 

/LOGIN 

/GLOBAL 

/SYSTEM 

/TERMINAL: ttnn: 



! Logical names same as 
! other device names: 
I Two characters, octal 
lunit number, and :. 



i Default 

JPrivileged 

JPrivileged 

JPrivileged; synonym for /GLOBAL, 

•Privileged 



ASSIGN/QDEDE 

See the RSX-11M/M-PLUS System Management Guide. 



ASSIGN/QUEUE establishes a path between a queue and a processor in the 
Queue Manager subsystem. Privileged. 



ASSIGN/QUEUE queuename processorname 



ASSIGN/REDIRECT 



Section 5.2.1 



ASSIGN/REDIRECT redirects output from one physical device to another. 
You can also redirect output from a physical device to a pseudo device 
or vice versa. Privileged. 



ASSIGN/REDIRECT oldddnn: newddnn: 
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ASSIGN/TASK 



Section 5.5.2 



ASSIGN/TASK reassigns an installed task's logical unit numbers (LUNs) 
from one physical device to another. The reassignment overrides the 
static LUN assignments in the task's disk image file. You cannot 
change the LUNs of an active task. Privileged. 



ASSIGN/TASK: taskname ddnn: lun 



BACKUP 

See also the RSX-11M/M-PLUS Utilities Manual, 



Section 5.9 



BACKUP backs up and restores Files-11 volumes. It transfers files 
from a volume to a backup volume and retrieves files from the backup 
volume. BACKUP works through the Backup and Restore Utility (BRU) . 
You should read carefully the main text entries on BACKUP and BRU 
before using this command. 



BACKUP [/qual if ier [s] ] sourceddnn: [f ilespec[s] ] destinationddnn: 

Command Qualifiers 

Group 1: Selective Backup and Restore 



/AFTER: (dd-mmm-yy hh:mm) 

/BEFORE: (dd-mmm-yy hh:mm) 

/CREATED 

/EXCLUDE 

/IMAGE:arg 

SAVE 

RESTORE 

/AM Ar\TClTDPl 
/ l'l\JU -LUX LJU 

/NEW_VERSION 
/[NO] REPLACE 

Group 2: Initialization 

/ACCESSED :n 

/BADBLOCKS:arg 

AUTOMATIC 

MANUAL 

OVERRIDE 
/EXTENSIONS 
/F I LE_PROT ECT I ON : code 
/HEADERS :n 
/INDEX:arg 

BEGINNING 

MIDDLE 

END 

n 



!Use with /CREATED or 
Iwith /MODIFIED. 

!For multivolume disk operations 



!n is default number of FCBs per 

! volume. 

[Default 



IDefault n=5. 

IDefault is protection of involume. 

'Specifies location of INDEXF.SYS 
Ion volume; default is location of 
Ifile on involume. 



! At logical block n, 
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/INITIALIZE 

/MAXIMUM_FILES:n 

/SAVE_SET:name 

/WINDOWS :n 



Group 3: Tape and Disk Control 

/APPEND 
/DENSITY:arg 

800 

1600 

6250 
/ERROR_LIMIT:n 
/LABEL : TAPE: fileset-ID 
/LENGTH:n 



/REWIND 



Group 4: Verification 

/COMPARE 
/VERIFY 

Group 5: Display 

/LIST 
/[NO] LOG 

Group 6: Disk Processing 

/DIRECTORY 
/NOINITIALIZE 



/LABEL:arg 



INPUT: volumelabel 
[OUTPUT: ] volumelabel 



[Default is name of volume being 
1 backed up. 

[Default is number of mapping 
[pointers on involume. 



!May need /REWIND; see main text, 



•Default density is 800 bpi . 
[Default n=25. 

[Usable length of output tape in 
[decimal feet; default n = physical 
[length of the output tape. 
[Rewind first tape of tape set 
[before executing the command line; 
[may use with /APPEND. 



/MOUNTED 
/[NO] PRESERVE 



J/LOG goes to TI : ; /NOLOG is default, 



[Can only be used with /NOINITIALIZE. 



[See also /LABEL : TAPE: volumelabel , 
!Gp 3. 

[/LABEL: OUTPUT is default; if the 
[only volumelabel in command line 
[is outvolume, /LABEL: volumelabel 
[will do. 

[/PRESERVE is default. 



BASIC 



Section 6.2.2 



BASIC invokes an interpreter or compiler for the BASIC language, 



BASIC[/qualif ier] [§filespec] 

Command Qualifiers 

/Bll 
/BP2 
/USING:userbasic 



!@filespec is BP2 only 



[BASIC-11 

1BASIC-PLUS-2; the default 
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BROADCAST 



Section 3.6 



BROADCAST displays a specified message at one or more terminals. 



BROADCAST ttnn: message 
BROADCAST usernamc message 
BROADCAST @indi rectspec 
BROADCAST [/qualifier] message 

Command Qualifiers 

/ALL 
/LOGGED IN 



•RSX-11M-PLUS only; no prompt, 



[Privileged 
[Privileged 



CANCEL 



Section 7.5 



CANCEL eliminates entries from the clock queue. CANCEL does not 
affect a currently executing task, just the pending entries in the 
clock queue. 



CANCEL taskname 



COBOL 



Section 6.2.4.1 



COBOL invokes the COBOL-81 compiler, 
compiler . 



COBOL-81 is the 



default 



COBOL[/qualif ier [s] ] filespec 

Command Qualifiers 

/[NO]ANSI_FORMAT 
/[NO] CHECK :arg 

[NO] BOUNDS 

[NO] PERFORM 

ALL 

NONE 
/CODE: [NO]CIS 
/ [NO] CROSS_REFERENCE 

/[NO] DEBUG 

/ [NO] DIAGNOSTICS [ : filespec] 
/[NO]LIST[:filespec] 
/NAMES: xx 



! Source is in conventional format. 
[Check ranges of subscripts, 
•indexes, and nested perform 
[statements at run time. 



•Use CIS in the object code produced, 

! Include cross-reference in listing 

[file. 

•Include Symbolic Debugger in task 

! image. 

[Create a diagnostic file. 

[Produce a listing file. 

•Use two characters you specify as 

[PSECT kernel. 
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/ [NO] OBJECT [ : f ilespec] 
,/[NO]OVERLAY_DESCRIPTION 

/[NO] SHOW: [NO] MAP 

/[NO] SKELETON 
/[NO] SUBPROGRAM 
/TEMPORARY :device 
/[NO] TRUNCATE 

/[NO] WARNINGS: [NO] INFORMATIONAL 



•Produce an object module. 

! Produce indirect command file and 

JOverlay Descriptor Language file. 

[Produce listfile and append two 

loffset maps. 

! Produce a skeleton ODL file. 

! Treat source file as a subprogram. 

I Store temporary work files. 

! Perform truncation on values of 

Icomp data items. 

! Issue informational, warning, and 

Ifatal diagnostics. 



COBOL/C11 



Section 6.2.4.2 



COBOL/C11 invokes the PDP-11 COBOL compiler, 



COBOL/C11 [/qualifier [s] ] f ilespec 
Command Qualifiers 



/[NO] ANSI_FORMAT 
/[NO] CHECK 

/Cll 

/[N0]CM6 

/ [NO] CROSS_REFERENCE 

/LARGE_SYMBOL_TABLE [ : n] 

/[NO] LIST[:f ilespec] 

/NAMES: xx 

/NEST:n 

/ [NO] OBJECT [ : f i lespec] 

/[NO] OVERLAY 

/ [NO] POOL_LITERALS 

/[NO] READONLY 

/[NO]SHOW: (arg[,s] ) 



COPY_LIST 

MAP 
VERB_LOCATION 

/[NO] SKELETON 
/[NO] SUBPROGRAM 
/TEMPORARY :dev 
/WARNINGS 
/NOWARNINGS 



Source in conventional format; A starts at 8. 

/NO means no bounds checking; /CHECK is 

default . 

Specifies PDP-11 COBOL compiler. 

/CM6 means COMPUTATIONAL-6 . 

Includes cross-reference in listing file. 

Allocate more symbol space; n=l-4; default n=l. 

/NOLIST is default; see main text for 

filespec defaults. 

Specify 2-character kernel for program section 

names . 

Depth of nested PERFORMS; default=10. 

/OBJECT is default; see main text 

for filespec defaults. 

Make all procedural program sections overlayable, 

See main text; PDP-11 COBOL documentation. 

Generate read-only program sections; default 

is /NOREADONLY or read-write. 

Specify additions to listing; a single argument 

needs no parentheses; multiple arguments must be 

separated by commas and enclosed in 

parentheses. 

/NOSH0W:COPY_LIST means no source statements 

from library included in listing. 

/SHOW:MAP means produce special map. 

/SHOW:VERB LOCATION means list location for 

each program verb. 

Produces skeleton ODL file; default is /SKL. 

Indicates subprogram. 

Assigns work files to a specified device. 

Warning and fatal diagnostics printed 

Only fatal diagnostics printed 
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CONTINUE 



Section 7.4 



CONTINUE resumes execution of a previously suspended task. 

CONTINUE [/qualifier] [taskname] 'Taskname defaults to TTnn 

Command Qualifier 

/TERMINAL:ttnn: [Privileged; RSX-11M-PLUS only. 



CONVERT 



Section 4.3.6 



CONVERT invokes the RMSCNV utility, which moves records from one file 
to another. RMSCNV reads records from an input file and writes them 
to an output file. The action of RMSCNV depends on the organization 
(sequential, relative, or indexed) of the two files and on the 
qualifiers you include with the CONVERT command. See the main text 
and the RMS-11 documentation supplied with your system for more 
information. 



CONVERT [/qual if ier [s] ] infile outfile 
rnrnmand Oualifiers 



/[NO] APPEND 
/BLOCK_SIZE:n 
/[NO]FIXED_CONTROL 
/[NO] IDENTIFICATION 

/INDEXED 

/KEY[:n] 

/ [NO] LOG_FILE[ : f ilespec] 

/[NO] MASS INSERT 

/MERGE 

/[NO]PAD[: [#]arg] 

/RELATIVE 
/[NO] REPLACE 
/SEQUENTIAL 
/[NO] TRUNCATE 



i/APPEND conflicts with /REPLACE. 

"Magtape block size: 18<=n<=8192; default=512. 

!/N0 is default. 

IPrints RMS version number; /NO is default; 

!no f ilespec required. 

lOutfile is indexed; see main text. 

!0<=n<=9; default=l. 

!/NO is default; no f ilespec logs on TI : 

IBoth files must have same organization. 

"Pad infile records to outfile length; default 

!pad character is blank (040) . 

JOutfile is relative. 

I/REPLACE conflicts with /APPEND. 

JOutfile is sequential. 

!/NO is default. 



COPY 



Section 4.3.4 



COPY copies files. Unless specified otherwise, COPY preserves the 
file organization of the input file, that is, indexed files are copied 
as indexed files, and so forth. See also the CONVERT command. 



COPY infile^s"' outfile 



'See main text for multiple file copies 
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Command Qualifiers 
/BLOCK SIZEtn 



/[NO] CONTIGUOUS 

/OWN 

/REPLACE 

/[NO]SPAN_BLOCKS 

/DATE :dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 



IDefines block size for outfile on 

Imagtape; n is octal unless terminated 

Iwith decimal point; no effect on 

! inf ile. 

ISpecifies contiguous outfile. 

IMakes outfile UIC owner of copy. 

! See main text 

SGiven day only 

IFrom given day through current day 

[From beginning through given day 

•From given day through given day 

! Today only 

IFilespec can include wildcards. 



CORAL 



Section 6.2.5 



CORAL invokes the CORAL 66 compiler. 



CORAL [/qualifier [s] ] f ilespec[ ,s] 



Command Qualifiers 

/[NO] CHECK 

/CODE:arg 

EIS 

FIS 

FPP 

PIC 

(EIS, PIC) 

(FIS,PIC) 

(FPP, PIC) 
/ [NO] EXTEND_SOURCE 

/ [NO] LIST [ : filespec] 

/ [NO] MACHINE_CODE 

/NAMES :x 

/ [NO] OBJECT [ : filespec] 

/ [NO] OPTIMIZE [ : LEVEL : n] 

/READ_ONLY[ :arg] 
ALL 
NONE 
PURE_DATA 

/[NO]SHOW[: (arg[,s] ) ] 
ALL 

[NO] EXPANSIONS 
NONE 

[NO] OVERRIDE 
[NO] SOURCE 
[NO] STATISTICS 
[NO] SYMBOLS 



IChecks boundaries of subscripts and 
! switches; default is /NOCHECK. 
ISpecifies choice of instruction set; 
'default is /CODE:EIS, 



Processes more than 72 characters or 

not; default is /EXTEND_SOURCE. 

Generates listing file or not; 

default is/NOLIST. 

Listing file includes generated machine 

code; default is /NOMACHINE_CODE. 

Compiler-generated program- sect ion 

names begin with x; default is S. 

Generate object module or not; 

default is /OBJECT. 

Optimize CORAL 66 source programs; 

default is /OPTIMIZE. 

Alter read-write or read-only attributes 

of program sections; default is 

/READ ONLY: PURE DATA. 



! Include or exclude elements from 

'listing file; default is /SHOW. 

•Default is /SHOW:NOEXPANSIONS. 

IDefault is /SHOW:NOOVERRIDE. 

IDefault is /SHOW:SOURCE. 

IDefault is /SHOW:STATISTICS. 

!Default is /SHOW: SYMBOLS. 
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/[NO] STANDARD 

/TEST[:n] 

/[NO]TRACEBACK 

/WIDTHm 



•Highlights non-IECCA keywords or not; 

! default is /NOSTANDARD. 

! Retain or omit declarations and 

! statements; default is /TEST:0. 

! Prints source-file and line-number 

•information in run-time messages; 

Idefault is /NOTRACEBACK. 

ISpecifies width of listing file; n = 8 

Jthrough 132; default is /WIDTH:132. 



CREATE 



Section 4.2.1 



CREATE creates a sequential file in a directory on a file-structured 
device. After you issue the command, you can immediately enter text. 
To end data entry and close the file, type CTRL/Z. See also 
CREATE/DIRECTORY. 



CREATE filespec 



CREATE/DIRECTORY 



Section 4.2.2 



CREATE/DIRECTORY creates a User File Directory (DFD) on a Files-11 
volume and enters its name in the volume's Master File Directory 
(MFD) , Nonprivileged users can only create directories on mounted 
volumes on their own private (allocated) devices. 



CREATE/DIRECTORY[/qualifier] [ddnn:] [g,m] 
Command Qualifiers 



/ALLOCATIONS 

/LABEL: vol umelabel 



lEntries for n files. 
•Compare with volume label. 



DEALLOCATE 



Section 5.5 



DEALLOCATE counteracts ALLOCATE. It frees a private device for access 
by others. 



DEALLOCATE [/qualifier] ddnn: 

Command Qualifier 

/ALL 

/DEVICE 

/TERMINAL:ttnn: 



IVolume must be dismounted, 



IFrees all devices allocated by TI : ; 
!do not specify ddnn:. 
! No-op 

1 Privileged:; RSX-llM-PLUS only. 
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DEASSIGN 



Section 5.3 



DEASSIGN deletes logical-device assignments. DEASSIGN disassociates 
logical names from physical device names, pseudo device names, or 
logical device names created by ASSIGN. See also other forms of the 
DEASSIGN command described in the following entries. 



DEASSIGN[/qualifier [s] ] logicalddnn: 
Command Qualifiers 



/ALL 

/LOCAL 

/LOGIN 

/GLOBAL 

/SYSTEM 

/TERMINAL:ttnn: 



[Combine with any other qualifier; 

!No ddnn: 

[Default 

[Privileged 

! Privileged 

! Synonym for /GLOBAL. 

[Default is TI:; otherwise privileged, 



DEASSIGN/QOEOE 

See the RSX-11M/M-PLUS System Management Guide. 



DEASSIGN/QUEUE counteracts ASSIGN/QUEUE. It is used to eliminate the 
path from a queue to a processor in the Queue Manager subsystem. 
Privileged. 



DEASSIGN/QUEUE queuename processorname 



DEBUG 



Sect ".:n 6.5 



DEBUG forces a Lank o« RSX-11M-PLUS to trap to a debugger by setting 
the i'-tut in the task's Processor Status Word. The task must have 
been built using the /DEBUG qualifier to the LINK command or have'' 

issued an Executive directive specif yinq a debugger. See main text. 

Nonpr ivileged users can issue this command for any nonpr ivi.leged task 
running from their own terminals. Privileged users can name any task, 
but the command must be issued from the same terminal the task was run 
from. 



DEBUG [taskname] 



[Default taskname is TTnn; RSX-11M-PLUS 
[only.. 
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DELETE Section 4.3.2 



DELETE deletes specified versions of files and releases the storage 
space the files occupy. See also other forms of the DELETE command 
described in the following entries. 



DELETE[/qualif ier [s] ] 

Command Qualifiers 

/[NO] LOG "Lists deleted files on TI : 

/[NO]QUERY IQueries before deleting; 

!/NO is default. 

/DATE:dd-mmm-yy IGiven day only 

/SINCE:dd-mmm-yy I From given day through current day 

/THROUGH :dd-mmm-yy IFrom beginning through given day 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy IFrom given day through given day 

/TODAY ! Today only 

/EXCLUDE: filespec IFilespec can include wildcards. 



DELETE/ENTRY 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual . 

DELETE/ENTRY deletes QMG jobs by entry number. 

DELETE/ENTRY:n[/qualif ier] !n is QMG entry number, 

Command Qualifier 

/FILE_POSITION:n 

DELETE/JOB 

See the RSX-llM/M-PLUS Batch and Queue Operations Manual . 

DELETE/JOB deletes QMG jobs by queuename and jobname. 

DELETE/JOB [/qualifier] queuename [ [g ,m] ] jobname 
Command Qualifier 

/FILE POSITION:n 
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DELETE/processortype 

See the RSX-11M/M-PLUS System Management Guide . 



DELETE/PROCESSOR deletes print processors, output despoolers, or batch 
processors from the Queue Manager subsystem by processor name or 
device name. This command also sets the device unspooled. 



DELETE/processortype processor name 
APPLICATIONS PROCESSOR 
BATCH_PROCESSOR 
CARD_READER 
DEVICE 
INPUT 
PRINTER 
PROCESSOR 



! INPUT is synonym. 
'PRINTER is synonym. 
!CARD_READER is synonym. 
iDEVICE is synonym. 



DELETE/QOEUE 

See the RSX-11M/M-PLUS System Management Guide . 



Privileged. DELETE/QUEUE deletes queues in the Queue Manager 
subsystem by name. See DELETE/JOB and DELETE/ENTRY to delete jobs 
from queues. 



DELETE/QUEUE queuename/ERASE I/ERASE is required, 



DIFFERENCES 



Section 4.4.5 



DIFFERENCES compares two ASCII (text) files line by line to determine 
if parallel records (lines) are identical and produces a listing of 
the differences between the files, if any. 



DIFFERENCES infilel infile2 
Command Qualifiers 
/CHANGE_BAR[:n] 

/IGNORE: (arg[,s] ) 

BLANK_LINES 

COMMENTS 

FORM_FEEDS 

SPACING 

TRAILING_BLANKS 
/LINES:n 
/[NO] NUMBERS 
/OUTPUT: f ilespec 
/SLP[ raudittrail] 



!n is octal ASCII code of alternate 
!bar. Default n=041 (!). 



[Comments begin with ";". 

IGroup of tabs and blanks = 1 blank. 

!n lines must be same for match. 
"Line numbers in output file. 
INames output file; TI: is default. 
lOutput is SLP indirect command file. 
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DIRECTORY 



Section 4.3.1 



DIRECTORY displays information on files in directories (UFDs) 



DIRECTORY [/format-qual] [/destination-qual] [other-qual [s] ] [f ilespec[s] ] 

Command Qualifiers 

Format 



/ATTRIBUTES 

/BRIEF 

/FREE [ddnn:] 

/FULL 
/SUMMARY 

Destination 

/OUTPUT [:filespec] 
/PRINTER 

Other Qualifiers 

/DATE : dd-mmm-yy 

/SINCE: dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH: dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 



[RMS-11 attributes 

[Free blocks on volume; default is 
!SY:. 

[Blocks used and allocated only. 



[Names output file. TI : is default. 
'Output to LPO: 

"Not used with /FREE or /ATT 

[Given day only 

[From given day through current day 

[From beginning through given day 

!From given day through given day 

! Today only 

[Filespec can include wildcards. 



DISMOUNT 



Section 5.7 



DISMOUNT marks the volume mounted on the specified device as logically 



iA Ai □ ,-./• 



DISMOUNT ddnn: [label] 



Command Qualifiers 



/ALL 
/PUBLIC 

/SAVE 



/SYSTEM 
/TERMINAL: ttnn: 

/ I NOJ UNLOAD 



!If label specified, volume label is 
! checked. 



[Dismount all devices mounted by user. 

•Privileged; dismounts all users from 

[volume. 

[Privileged; disk keeps spinning; 

[privileged tasks can access; 

[RSX-11M-PLUS only. 

[Synonym for /PUBLIC. 

[Privileged; dismounts volumes mounted 

[from another terminal. 

[Alrects DB:, DM:, and DU: devices; 

[see main text; RSX-11M-PLUS only. 
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EDIT[/EDT] 

See also the EDT Editor Manual. 



Section 4.2.3.1 



EDIT or EDIT/EDT invokes EDT, the DEC Standard Editor, 
default editor. 



EDT is the 



EDIT[/EDT] [/qualifier [s] ] filespec 
Command Qualifiers 



/ [NO] COMMAND [ : f i lespec] 
/ [NO] JOURNAL [ : fi lespec] 
/ [NO] OUTPUT [ : filespec] 
/[NO]READ_ONLY 
/[NO] RECOVER 



"Default is /COMMAND: EDT IN I .EDT. 



IDefault is /NOREAD_ONLY. 
'Default is /NORECOVER. 



EDIT/SLP 

See also the RSX-11M/M-PLUS Utilities Manual . 



Section 4.2.3.2 



EDIT/SLP invokes the Source Language Input Program (SLP) 
program-maintenance editor. 



EDIT/SLP[/qualif ier [s] ] filespec 
Command Qualifiers 

/[NO] AUDIT [: (arg[s] ) ] 

POSITIONrn 

SIZE:n 
/CHECKSUM [:n] 
/[NO]LIST[:filespec] 
/ [NO] OUTPUT [ : filespec] 
/[NO] REPORT 

/[NO] TAB 



/[NO] TRUNCATE [:n] 



IDefault is /AUDIT: (POS: 80:SIZ: 8) 
•n must be <=132. 
!n must be <14. 



IReport truncation of lines by audit 

! trail. 

•Right-justify with tabs or spaces; 

1/NOTAB is default. 

•/TRUNCATE deletes audit trails and 

•trailing characters; optionally 

Jtruncates text at specified 

Ihorizontal position. 



EDIT/EDI and EDIT/editor 



Section 4.2.3.3 



EDIT/EDI invokes EDI, the Line Text Editor, 
user-specified editor (see list below). 



EDIT/editor invokes a 



EDIT[/qualif ier] [edit-input] "Input accepted by editor 
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Command Qualifier 

/EDI 

/KED 

/K52 

/MAKE 

/MUNG 

/OUTPUT: filespec 

/CREATE 

/SOS 

/TECO 

/USING:yyy 



'Line Text Editor. 

"Unbundled KED editor. 

!VT52 version of unbundled KED editor, 

[Unsupported TECO function. 

[Unsupported TECO function. 

!Use with /KED and /K52 (unbundled 

[editors) . 

!Use with KED and K52. 

! Unsupported Son of Stopgap. 

[Unsupported Text Editor and 

[Corrector . 

[Unsupported user editor. 



FIX 



Section 7.10 



FIX causes an installed task or region to be loaded and locked into 
memory. Privileged. 



FIX [/qualifier] taskname 
Command Qualifiers 

/READONLY_SEGMENT 
/REGION 



IName task or region. 



[Read-only segment of 

[multiuser task; RSX-ilM-PLUS only; 

[common region; RSX-ilM-PLUS only. 



FORTRAN 



Section 6.2.3 



FORTRAN invokes a FORTRAN compiler. 



FORTRAN [/qualifier [s] ] filespec [s] 
Command Qualifiers 



/[NO]CHECK 
/C0DE:arg 

EAE 

EIS 

FIS 

THREADED 
/CONTINUATIONS:n 
/[N0]DLINES 
/ [NO] EXTEND_SOURCE 
/FOR 
/F4P 
/[NO]F77 
/IDENTIFICATION 
/[NO] 14 

/[NO]LINE_NUMBERS 
/[N0]LIST[:f ilespec] 



!F4P and F77; default is /NOCHECK. 
[FOR only; mutually exclusive options. 
[Extended Arithmetic Element. 
[Extended Instruction Set. 
[Floating Instruction Set. 

!F4P and F77; n=0-99 continuation lines. 

[D-lines compiled or not. 

[FIV and F77; accept more than 72 columns or not. 

[Code is FORTRAN-IV; default. 

[Code is FORTRAN- IV-PLUS. 

[Code is FORTRAN-77; /NOF77=/F4P. 

■Compiler and version. 

1/NOI4 is default; 14 is 2-word variables. 

[FORTRAN Internal Sequence Numbers. 

[Default is /NOLIST. 
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/ [NO] MACHINE_CODE 
/[NO] MAP 

/[NO]OBJECT[:f ilespec] 
/SHAREABLE 
/SOURCE 

/[NO]STANDARD:arg 
ALL 
NONE 
SOURCE 
SYNTAX 
/ [NO] TRACEBACK:arg 

ALL 

BLOCKS 

LINES 

NAMES 

NONE 
/USING: user compiler 
/[NO] VECTORS 
/[NO] WARNINGS 
/WORK FILES :n 



'/OBJECT is default. 
!F4P and F77. 



1ANSI standard 
1/NOSTANDARD. 



extensions; default is 



!F4P and F7 7. 
ILINES 



is synonym. 



iALL is synonym. 



!FOR only; default is vectored arrays. 
IFOR only; default is warning diagnostics. 
!F4P and F77; n is maximum for temporary files, 



HELP 



Section 3.5 



Help displays information about your system. Help files for MCR, DCL, 
and most utilities are supplied with the system. Your system may also 
have help for an alternate CLI or local, group, or other special help. 
See main text. 



HELP[/qualif ier [s] ] [parameterl . . .parameter!?] 
Command Qualifiers 



/OUTPUT: f ilespec 

/LOCAL 

/GROUP 

/CLI :cliname 

/MCR 

/DCL 

/FILE:f ilespec 

/filename 



"Help text to file; default /OUTPUT:TI:. 
!Help file is in default UFD; HELP % is same, 
JHelp file is in [g,l]; g is your group. 
!For alternate CLIs. 

!MCR help; default for MCR terminals. 
!DCL help; default for DCL terminals. 
INames file containing help text. 
•LB: [1,2] filename. HLP 



HOLD/ENTRY 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual , 

HOLD/ENTRY holds a QMG job in its queue by entry number. 



HOLD/ENTRY:n 



!n is QMG entry number, 
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HOLD/JOB 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual . 

HOLD/JOB holds a QMG job in its queue by queuename and jobname, 



HOLD/JOB queuename [ [g ,m] ] jobname 



INITIALIZE 



Section 5.8 



INITIALIZE produces a volume in Files-11 format. See also 
INITIALIZE/UPDATE. You must mount the volume /FORK1GN on 
RSX-11M-PLUS. You can mount the volume /FOREIGN on RSX-11M, but it is 
not required. See main text. See also other forms of the INITIALIZE 
command described in the following entries. 



INITIALIZE [/qualifier [s] 

Command Qualifiers 

/ACCESSED :n 

/BAD_BLOCKS:arg 

AUTOMATIC 

MANUAL 

OVERRIDE 
/DENSITY:arg 

800 

1600 

6250 
/EXTENSIONS 

/FILE_PROTECTION: (code) 

/HEADERS :n 
/INDEX:arg 

BEGINNING 

MIDDLE 

END 

n 
/MAXIMUM_FILES:n 
/OWNER: [g,m] 
/PROTECTION: (code) 
/[NO] SHOW 

/WINDOWS :n 



ddnn: volumelabel JNonpr ivileged must 

lallocate the device. 



INumber of UFDs accessed simultaneously. 
[Default 



lExtend full files by n blocks; 
Jdefault n=5. 

iDefault protection for files 
Jon volume. 

! Locates index file on volume. 
•Default for tapes and DECtapes . 
IDefault for disks. 

!At logical block n. 



IDefault protection for volume. 
•Display volume information on TI:; 
!/NO is default. 

IMapping pointers to file windows; 
'default n=7. 
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INITIALIZE/PROCESSOR (Output) 

See the RSX-11M/M-PLUS System Management Guide . 



INITIALIZE/PROCESSOR creates, names, and starts an output despooler or 
batch processor. Privileged. See next entry to initialize an input 
spooler. 



INITIALIZE/processortype processor name [/qualifier [s] ] 

Processor types : 

APPLICATIONS_PROCESSOR 

BATCH_PROCESSOR 

DEVICE 

PRINTER 

PROCESSOR 



Command Qualifiers 

/FLAG_PAGE:n 
/FORMS :n 
/[NO] SHAREABLE 
/[NO] LOWERCASE 
/[NO] UPPERCASE 



!n can be 0-2; default n=l. 
!n can be 0-255; default n=0, 
•Default is NOSHAREABLE. 
'Default is LOWERCASE, 
•Default is NOUPPERCASE. 



INITIALIZE/PROCESSOR (Input) 

See the RSX-llM/M-PLUS System Management Guide. 



INITIALIZE/processortype creates, names, and starts an input spooler 
or card-reader processor. Privileged. See previous entry to 
initialize an output despooler. 



INITIALIZE/processortype processorname[/qualif ier [s] ] 
CARD_READER ! INPUT is synonym. 
INPUT 'CARD READER is synonym. 



Command Qualifiers 

/BATCH_QUEUE : gu = i ■ -.name 

/CONSOLE :ddnn: 

/PRINTER QUEUE :gueuename 
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INITIALIZE/QUEUE 

See the RSX-llM/M-PLUS System Management Guide , 



INITIALIZE/QUEUE creates, names, and starts a queue in the Queue 
Manager subsystem. 



INITIALIZE/QUEUE queuename [/quali f ier ] 
Command Qualifiers 



/BATCH 

/PRINTER 

/NOWARNINGS 



'Default 



INITIALIZE/DPDATE 



Section 5.8.1 



INITIALIZE/UPDATE invokes the HOME utility to alter values in the 
volume home block without affecting the other data on the volume. 
INITIALIZE/UPDATE is only for disks and DECtapes in Files-11 format. 

You must mount the volume /FOREIGN on RSX-11M-PLUS. You can mount the 
volume /FOREIGN on RSX-11M, but it is not required. See main text. 



INITIALIZE/UPDATEt/qualifier [s] ] ddnn: volumelabel 

Command Qualifiers 

/ACCESSED :n 
/DENSITY:arg 
800 

1600 

6250 



/F I LE_PROTECTI ON : code 

/OWNER: [g,m] 

/MAXIMUM_FILES:n 

/PROTECTION: code 

/[NO] SHOW 

/ L ABEL :newvolume label 

/WINDOWS:n 



£,'1—— 1 _ X~. 1 A -. V ~ 

j.j.xcro My it vj.*j*~Ko» 

•Default protection for files on volume. 

IMaximum number of files on volume. 
IProtection for volume. 

! Changes volume label. 

IMapping pointers to file windows; default n=7. 



INSTALL 



Section 7.8 



INSTALL includes a task in the System Task Directory, thus making it 
known to the system. Privileged. 



INSTALLf/qualifier [s] ] [$) f ilespec 
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Command Qualifiers 



/[NO] CHECKPOINT 

/COMMAND : " taskcommand " 

/EXTENSION:n !n (octal) additional words of address 

! space. 

/MOLTIUSER_PARTITION:parname "Install read-only portion. 
/PARTITION: par name 
/[NO] POSTMORTEM 

/PRIORITY:n 10-250. 

/READONLY_COMMON ! Install common as read-only. 

/[NO] SLAVE 1/NOSLAVE is default. 

/TASK_NAME: taskname !l-6 characters. 
/VIC: [g,m] 



LIBRARY Section 6.3 

See also the RSX-11M/M-PLUS Utilities Manual. 



LIBRARY creates and maintains user-written library files. The command 
has eight functions, each listed here as a separate command. See main 
text for more details on all functions and qualifiers. 



LIBRARY[/operation] [/quali f ier [s] ] 

LIBRARY @filespec ! Indirect command file specification. 

LIBRARY/COMPRESS Section 6.3.1 



LIBRARY/COMPRESS physically deletes modules that have been logically 
deleted through LIBRARY/DELETE. You can rename the resulting 
compressed library. You can also use this command to copy a library 
and rename it. 



LIBRARY/COMPRESS [: (arg[ ,s] ) ] libspec [newlibspec] 

GLOBAL:n ! Entry-point table entries. 

MODULES:n "Module-name table entries. 

BLOCKS:n !Size in 256-word blocks. 



LIBRARY/CREATE Section 6.3.2 



LIBRARY/CREATE creates a library and optionally inserts one or more 
modules into it. 



LIBRARY/CREATE [: (arg [ ,s] ) ] [/qual i f ier [s] ] libspec [inf ilespec [s] 
GLOBAL:n ! Entry-point table entries. 

MODULES:n IModule-name table entries. 

BLOCKS:n !Size in 256-word blocks. 
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Command Qualifiers 

/[NO]GLOBALS 

/MACRO 

/OBJECT 

/SELECTIVE_SEARCH 

/SQUEEZE 

/UNIVERSAL 



! Include globals in entry-point table. 
! Identifies macro library. 
[Default; identifies object library. 
[Object modules only. 

[Identifies universal library. 



LIBRARY/DELETE 



Section 6.3.3 



LIBRARY/DELETE deletes object modules from a library. See 
LIBRARY/REMOVE for removing global symbols (entry points) from a 
1 ibrary . 



LIBRARY/DELETE libspec module [, module [ ,s] [Name as many as 15 modules 



LIBRARY/EXTRACT 



Section 6.3.4 



LIBRARY/EXTRACT reads one or more modules from a library and writes 
them to a specified output file. You can extract as many as eight 
modules with a single command. If you extract more than one module, 
the modules are concatenated in the output file. 



LIBRARY/EXTRACT [/qual if ier] libspec module[,s] 
Command Qualifier 



/OUTPUT[:filespec] 



'Default output file is TI:; name 
!a file when extracting object 
[modules. 



LIBRARY/INSERT 



Section 6.3.5 



LIBRARY/INSERT inserts modules from one or more files into a library. 



LIBRARY/INSERT libspec filespec[s] [Name any number of files 
Command Qualifiers 



/[NO] GLOBALS 

/SELECTIVE_SEARCH 

/SQUEEZE 



[Include globals in entry-point table. 
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LIBRARY/LIST Section 6.3.6 



LIBRARY/LIST lists on your terminal or in an output file the names of 
all modules in a library. 



LIBRARY/LIST[:filespec] libspec 

Command Qualifiers 

/BRIEF 

/FULL 

/[NO] NAMES ! Names plus global entry points. 



LIBRARY/REMOVE Section 6.3.7 



LIBRARY/REMOVE removes global symbols (entry points) from a library. 
See LIBRARY/DELETE for deleting object modules from a library. 



LIBRARY/REMOVE libspec global [, global [ ,s] ! Name as many as 15 global symbols 



LIBRARY/REPLACE Section 6.3.8 



LIBRARY/REPLACE replaces a module in a library with a new module of 
the same name and deletes the old module. 



LIBRARY/REPLACE libspec filespec[s] 

Command Qualifiers 

/[NO]GLOBALS ! Include globals in entry-point table. 

/SELECTIVE_SEARCH 

/SQUEEZE 



LINK Section 6-4 



LINK invokes the Task Builder, which links object modules and routines 
from user and system libraries to form an executable task. 



LINK [/qualifier [s] ] f ilespec [/quali f ier [s] ] [ , f ilespec [s] ] 
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/ANCILLARY_PROCESSOR[ :n] 

/BASIC 

/[NO]CHECKP0INT:arg 

SYSTEM 

TASK 
/CODE: (arg [ ,s] ) 

DATA SPACE 

EAE 

FPP 

PIC 

POSITION_INDEPENDENT 
/COMPATIBLE 
/ [NO] CROSS_REFERENCE 
/ [NO] DEBUG [ : f i lespec] 
/ [NO] EXECUTABLE: filespec 
/ERROR_LIMIT:n 
/[NO] EXTERNAL 
/FAST 

/FULL_SEARCH 
/[NO] HEADER 
/[NO] IO_PAGE 
/LONG 

/MAP[ :f ilespec] 
/ [NO] MEMORY_MANAGEMENT [ :n] 

/OPTIONS[ :f ilespec] 

/OVERLAY_DESCRIPTION 

/POSTMORTEM 

/[NO] PRIVILEGED! :n] 

/[NO] RECEIVE 

/ [NO] RESIDENT OVERLAYS 

/SAVE 

/SELECTIVE_SEARCH 

/[NO] SEGREGATE 

/SEQUENTIAL 

/SHAREABLE!: arg] 

COMMON 

LIBRARY 

TASK 
/SbAvS 
/SLOW 

/SYMBOLJTABLE [ : filespec] 
/ [NO] SYSTEM_LIBRARY_DISPLAY 
/ [ NO] TASK [ : f i lespec ] 



/TKB 

/TRACE 

/[NO]WARNINGS 

/WIDE 



[Task is ACP; n is 0,4, or 5. 



[Checkpoints to [0 ,0] CORIMG.SYS. 
! Checkpoints to task image file. 

SRSX-11M PLUS only. 
! Extended arithmetic element. 
[Floating-point processor. 
[Position-independent code. 
[Synonym for PIC. 



[Default is ODT. 

[Names task file. Synonym for /TASK. 
[Stop task build after n errors. 
[P.SX-11M-PLMS only. 

[Fast TKB. 



! Long map 

[Default is /MAP:TI: 

!n for unmapped systems; see main 

[text; default is /MEM; n is 28 (default) or 30. 

[File contains options. Otherwise you will be prompted 



[Default is /NOPRIVILEGED. 

[Saves indirect file. 
[/NOSEG is default. 
[Multiuser 



[Default; RSX-11M-FEUS only 

[Slow TKB. 

[Output .STB file 

[Default is /NOSYS. 

[Names task image file; /EXECUTABLE 

[is synonym; names 1-6 characters; 

1/NOTASK means no task built. 

[Default 

[/NO suppresses diagnostic messages; /WARNINGS is 

[default. 

[Wide map 



File Qualifiers 



/[NO] CONCATENATE 
/DEFAULT_LIBRARY 
/[N0]GLOBALS 

/LIBRARY 

/INCLUDE: (modulel [ : . . . :modulen] ) 

/OVERLAY_DESCRIPTION 
/SELECTIVE SEARCH 



[File to replace [1 , 1 [SYSLIB.OLB 
[Default is /GLOBALS; includes 
[global symbols in map. 
[File is object module library. 
[File is object module library; 
[include named modules in task image. 
[File is .ODL; also a command qualifier. 
[Also a command qualifier. 
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LINK/C81 or LINK/COBOL 



Section 6.4.3 



LINK/C8I invokes the Task Builder and the COBOL BLDODL facility, and 
indicates that COBOL-81 object modules are being linked. 



LINK/C81 [/qualifier [s] ] filespec[,s] 

LINK/COBOL[/qualifier [s] ] filespec[,s] 

Command Qualifiers 

/[NO]FMS !/FMS:NORESIDENT equivalent to /FMS. 

/OTS: [NO] RESIDENT 

/[NO] RMS 

/RMS: [NO] RESIDENT 

/[NO] MAP 

/[NO] DEBUG 



LOGIN 



Section 3.1.1 



LOGIN (or HELLO) grants access to a multiuser protection system and 
establishes your privileges as a system user. 



LOGIN userid password 



! HELLO is synonym. 



LOGOUT 



Section 3.1.2 



LOGOUT counteracts LOGIN. LOGOUT also aborts any nonpr ivileged tasks 
running from the terminal and also dismounts any volumes and 
deallocates any private devices allocated from the terminal. 



LOGOUTf/qualifier] 
Command Qualifier 

/[NO] HOLD 



!LO is sufficient 



SHolds remote line after logout; /NO 
lis default. 



MCR 



Section 1.2.4 



MCR enters an MCR command from a DCL terminal without leaving DCL. 



MCR mcrcommand 
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MACRO 



Section 6.2.1 



MACRO invokes the MACRO-11 Relocatable Assembler, which assembles one 
or more MACRO-11 source files into a single relocatable object module 
suitable for processing by the Task Builder. 



MACRO [/qualifier [s] ] filespec [/qualifier [s] ] [ , f ilespec[ , s] ] 
Command Qualifiers 



/ [NO] CROSS_REFERENCE 
/DISABLE: (arg[,s] ) 

ABSOLUTE 

BINARY 

CARD_FORMAT 

GLOBAL 

LOCAL 

LOWERCASE 

REGISTER_DEFINITIONS 

TRUNCATION 
/ENABLE: (arg[ ,s] ) 

ABSOLUTE 

BINARY 

CARD_FORMAT 

GLOBAL 

LOCAL 

LOWERCASE 

REGISTER_DEFINITIONS 

TRUNCATION 
/[NO]LIST[:filespec] 
/ [NO] OBJECT [ : filespec] 
/[NO]SHOW[: (arg[,s] ) ] 

ALL 

BINARY 

CALLS 

COMMENTS 

CONDITIONALS 

CONTENTS 

COUNTER 

DEFINITIONS 

EXPANSIONS 

EXTENSIONS 

LISTINGJDIRECTIVES 

OBJECT_BINARY 

SEQUENCE_NUMBERS 

SOURCE 

SYMBOLS 
/[NO]WIDE 

File Qualifiers 

/LIBRARY 
/PASS:n 



•Default is /NOCROSS. 
! Parentheses not required 
!if single parameter; see 
Imain text for meaning of 
iparameters. 



IParentheses not required 
!if single parameter; see 
imain text for meaning of 
Iparameters. 



"Default is /NOLIST. 

! Default is /OBJECT. 

! Parentheses not required 

!if single parameter; see 

Jmain text for meaning of 

Iparameters. ALL is default, 



IFile is macro library. 

! Assemble file on pass 1 or 2, 
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MOUNT 



Section 5.6 



MOUNT declares a volume to be logically known to the system, on line, 
and available for use. Some qualifiers can be used with any MOUNT 
command; some are limited to mounting disks (and other 
random-addressable devices) and others are limited to mounting 
magnetic tapes. 



Format for Disks and Other Random-Addressable Devices 

MOUNT [/qualifier [s] ] ddnn: volumelabel 

Format for Magnetic Tapes 

MOUNT[/qualif ier [s] ] ddnn: [, ddnn: ... ] fileset-ID 

Command Qualifiers for Both Disks and Tapes 



! Sets defaul ts rot 



/DEFAULT :arg 

SAVE 

NOON-LOAD 

UNLOAD 
/FILE_PROTECTION: (code) 
/FOREIGN 

/OVERRIDE: IDENTIFICATION IPrivileged; no label needed 
/PARAMETERS: "user parameters" IQuotes are required syntax 



a J s 110 u r t ; se o ma i n 



fee*- . 



[Protection for files created during mount 



/PROCESSOR:arg 

acpname 

UNIQUE [ : acpname] 
/PROTECTION: (code) 
/PUBLIC 

/[NO] SHAREABLE 
/[NO] SHOW 
/SYSTEM 
/[NO]WAIT 
/[NO] WRITE 



IPrivileged; name ACP for volume. 



IVolume protection during mount 
IPrivileged; deallocates; sets public, 

IDisplay volume information on TI : . 
I Synonym for /PUBLIC. 
•Default is /NOWAIT. 



Command Qualifiers for Files-11 Devices 



/ACCESSED :n 
/EXTENSION: n 
/OWNER: [g,m] 
/UNLOCK 
/WINDOW: n 



!n is number of File Control Blocks. 
! Extend full files by n blocks. 
JCoordinate with file and volume protection 
!Main use is with VFY. 



Command Qualifiers for ANSI and Unlabeled Tapes 

See main text for these qualifiers. 

/BLOCK_SIZE:n 

/CARRI AGE_CONTROL : arg 

FORTRAN 
LIST 
NONE 
/DENSITY:arg 
800 
1600 
6250 
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/[N0]HDR3 
/[NO] LABEL 
/OVERRIDE: (arg[,s] ) 

ACCESSIBILITY 

EXPIRATION_DATE 

SET_IDENTIFICATION 
/RECORD_SIZE:n 
/TRANSLATE :arg 

EBCDIC 

NONE 

UT1 

UT2 

UT3 
/VOLUME IDENTIFICATION: (volume-ID [ ,volume-ID [ ,s] ] 



PRINT 



Section 4.4.2 



PRINT queues files for printing on a line printer, 
queue jobs for other output devices. 



PRINT can also 



PRINT [/qualifier [s] ] filespec [/qualifier [s] ] [ , f ilespec[ , s] ] 
Command Qualifiers 



/AFTER: (dd-mmm-yy hh:mm) 

/COPIES:n 

/[NO] DELETE 

/DEVICE:ddnn: 

/[NO]FLAG_PAGE 

/FORMS :n 
/[NO] HOLD 

/JOB_COUNT 
/[NO] JOB_PAGE 
/LENGTH :n 
/[NO] LOWERCASE 
/NAME: jobname 

/ r»J(-l! T1V> 1MCPTO 

/PAGE_COUNT:n 
/PRIORITY:n 

/QUEUE : queuename 
/[NO] RESTART 
/[NO] UPPERCASE 

File Qualifiers 

/COPIES:n 

/[NO]DELETE 
/[NO] TRANSFER 



•Override on filespec. 
lOverride on filespec. 

'Flag page on each file; default is 

!/NOFLAG_PAGE. 

!n can be 0-256; default n=0. 

IDefault is /NOHOLD; same effect as 

1HOLD command. 

IFlagpage on job; default /JOB_PAGE. 
! Page length 

!l-9 characters 

!Limit pages in job. 

!n is 1-150 nonprivileged ; through 250 

Sprivileged; default n=50. 
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PURGE Section 4.3.3 



PURGE deletes all but the latest versions of files and releases the 
storage space the deleted files occupy. 

PURGE [/qualifier [s] ] filespec[s] 

Command Qualifiers 

/KEEPin 

/[NO]LOG ILists files on TI: as deleted. 

/DATE:dd-mmm-yy ! Given day only 

/SINCE :dd-mmm-yy IFrom given day through current day 

/THROUGH :dd-mmm-yy IFrom beginning through given day 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy IFrom given day through given day 

/TODAY ! Today only 

/EXCLUDE: filespec IFilespec can include wildcards. 



RELEASE/ENTRY 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual . 

RELEASE/ENTRY releases by entry number a print or batch job that has 
been held in its queue. 

RELEASE/ENTRY :n !n is QMG entry number. 

RELEASE/ JOB 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual . 

RELEASE/JOB releases by queuename and jobname a print or batch job 
that has been held in its queue. 

RELEASE/JOB queuename [ [g,m] ] jobname 

REMOVE Section 7.9 



REMOVE counteracts INSTALL. REMOVE takes a task name out of the 
System Task Directory. Privileged. 

REMOVE [/qualifier] taskname 

Command Qualifier 

/REGION iTakes name of region out 

!of Common Block Directory and , 
Ipartition list; RSX-11M-PLUS only. 
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RENAME 



Section 4.3.5 



RENAME changes the name, type, or version number of an existing file. 



RENAME [/qualifier [s] ] oldfilespec newfilespec 

Command Qualifiers 

/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/THROUGH :dd-mmm-yy 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE: f ilespec 



!Watch wildcards and version numbers. 



IGiven day only 

!From given day through current day 

IFrom beginning through given day 

[From given day through given day 

[Today only 

IFilespec can include wildcards. 



REQUEST 



Section 3.7 



REQUEST sends a message to the operator's console (CO:) 



REQUEST message 



! Optional "quotes" around message 



RUN uninstalled task 



Section 7.2.1 



When used to run an uninstalled task (from a task image file) , RUN is 
a combination command, encompassing INSTALL, RUN, and REMOVE. See 
main text. 



RUN[/qualif ier [s] ] [$]filespec 

Command Qualifiers 

/[NO] CHECKPOINT 
/COMMAND : " taskcommand " 
/EXTENSIONS 

/PART IT ION: par name 
/[NO] POSTMORTEM 
/PRIORITY:n 
/STATUS :arg 

TASK 

COMMAND 
/TASK_NAME:taskname 
/T I meJ'l I M I T : n [ u ] ■ . . '■',, ■: " - ' ■ : , 

/UIC: [g,m] 



!See main text. 

!n (octal) additional words of address 

! space . 

! Privileged 

IPrivileged 



!l-6 characters 

JArcpis M "tminuteis) ■..:■.,.'■**" *;■■■;;, C::Z':'-:c: 

iby default; can also be S (seconds) ; 
IRSX-11M-PLUS only. 3M is default. 
i Privileged . 
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RON installed task 



Section 7.2.2 



RUN also initiates the execution of installed tasks. Privileged users 
can use RUN to initiate the execution of installed tasks on a schedule 
by creating entries in the system clock queue. 



RUN[/qualif ier [s] ] taskname 
Command Qualifiers 
/DELAY :nu 



/INTERVAL :nu 
/SCHEDULE : hh : mm : ss 
/STATUStarg 

COMMAND 

TASK 



/SYNCHRONIZED 
/UIC:[g,m] 



!A11 privileged except /STATUS 

In is the number of units and u is the 
Itime unit: T, ticks; S, seconds; 
!M, minutes; H, hours. 



[Return status from RUN command; default, 

IReturn status from task being run; 

!see main text on both these 

! arguments. 

ISynchronize on next T, S, M, or H. 



SET [DAY] TIME 



Section 8.1.1 



SET [DAY] TIME sets the system date and time. Privileged, 



SET [DAY] TIME: [dd-mmm-yy] [hh:mm] JSet at least one; either order. 



SET DEFAULT 



Section 4.5.1 



SET DEFAULT establishes your default device or UFD, or both. 



SET DEFAULT[ :ddnn: ] [[g,m]] 



JUnadorned SET DEF returns 
Inonprivileged user to login device 
land UFD. 



SET DEVICE 



Section 5.10.2 



SET DEVICE establishes certain device attributes. Privileged, 



SET DEVICE:ddnn:/qualif ier [s] 
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Command Qualifiers 

/ [NO] CHECKPOINT_FILE [ : n] 

/[NO] LOWERCASE 
/[NO] PUBLIC 
/WIDTH :n 



!n is number (decimal) of blocks in 
! [0,0]CORIMG.SYS. 
'Default is /NOLOWERCASE. 
IDefault is /NOPUBLIC. 
INonprivileged for TI:. 



SET GROUPFLAGS 



Section 6.6.1 



SET GROUPFLAGS creates and deletes group global event flags. See main 
text. 



SET GROUPFLAGS: n[/qual if ier] INonprivileged command for own group 

!n is group number. 



Command Qualifiers 

/CREATE 
/DELETE 



IDefault 



SET LIBRARY/DIRECTORY 



Section 8.1.4 



SET LIBRARY/DIRECTORY establishes the RSX-11M-PLUS directory where the 
system utilities and other nonprivileged system tasks are kept. 
Privileged . 



SET LrBRARY/DIRECTORY: [g,m] 'Does not create a directory. 



SET [NO] PARTITION 



Section 7.12.1 



SET [NO] PARTITION creates or eliminates a partition. Privileged, 
SET [NO] PARTITION:parname/gualif ier [s] IParname 1-6 characters 
Command Qualifiers 



/BASE:n 

/COMMON 

/DEVICE 

/DIAGNOSTIC 

/SIZErn 

/[NO] SUBPARTITION: subparriame 1RSX-11M only. 

/SYSTEM 

/TASK 

/TOP: value 



' K3X-.1 1M Only 

[Device common. 
"RSX-11M-PLUS only, 



■RSX-1.1M only, 
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SET PRIORITY 



Section 7.12.8 



SET PRIORITY alters the priority of an active task. Privileged, 



SET PRIORITY:n taskname 



!n = through 250 



SET PROTECTION 



Section 4.5.3 



SET PROTECTION establishes the protection status of files, 



SET PROTECTION: code [/qualifier [s] ] filespec[s] 'The preferred syntax; 



SET PROTECTIONt/qualif ier [s] ] f ilespec [s] (code) 

Command Qualifiers 

/DATE : dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH: dd-mmm-yy 

/TODAY 

/EXCLUDE: f ilespec 



idefault is (SY:RWED,OW:RWED,GR:RWED,W:R) 



[Given day only 

'From given day through current day 

'From beginning through given day 

"From given day through given day 

! Today only 

'Filespec can include wildcards. 



SET QUEUE/ENTRY 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual , 



SET QUEUE/ENTRY modifies by entry number some attributes of print or 
batch jobs once they are in a queue. See SET QUEUE/JOB to modify by 
j ob name . 



SET QUEUE/ENTRY:n [/qualifier] 

Command Qualifiers 

/AFTER: (dd-mmm-yy hh:mm) 

/COPIES:n 

/[NO] DELETE 

/FILE_POSITION:n 

/FORMS :n 

/HOLD 

/LENGTH :n 

/[NO] LOWERCASE 

/PAGE_COUNT:n 

/PRIORITY:n 

/RELEASE 
/[NO] RESTART 
/[NO] UPPERCASE 



!Only one attribute at a time 



[Same as HOLD/QUEUE 



!n is 1-150 nonprivileged; through 250 
'privileged; default n=50. 
•Same as RELEASE/QUEUE 
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SET QUEUE/JOB 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual. 



SET QUEUE/JOB modifies by job name some attributes of print or batch 
jobs once they are in a queue. See SET QUEUE/ENTRY to modify by entrv 
number. •* ■* '=' ll - i Jr 



SET QUEUE/JOB [/qualifier] queuename [ [g,m] ] jobname 

!Only one attribute at a time 

Command Qualifiers 

/AFTER: (ddd-mmm-yy hh:mm) 

/COPIES :n 

/[NO] DELETE 

/FILE_POSITION:n 

/FORMS :n 

/HOLD 

/LENGTH :n 

/[NO] LOWERCASE 

/PAGE_COUNT:n 

/PRIORITY:n 



/RELEASE 
/[NO] RESTART 
/[NO] UPPERCASE 



!Same as HOLD/QUEUE 



!n is 1-150 nonprivileged; through 250 
iprivileged; default n=50. 
!Same as RELEASE/QUEUE 



SET SYSTEM 



Section 8.1.3 



SET SYSTEM establishes certain characteristics of the system. It i 
privileged command. r 1T: 1 



s a 



SET SYSTEM/qualifier 
Command Qualifiers 

/DIRECTORY: [g,m] 
/EXTENSION LIMIT:n 



/[NO] LOGINS 

/PACKETS :n 

/POOL : top :max : total 



IQualifier required 



ISets UFD where system tasks are kept; 

!does not create a directory. 

ISets maximum size a task can extend 

! itself with the Extend Task 

Idirective. 

!n = through 15 

! Increases size of pool; see main 

Itext. 
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SET TERMINAL Section 3.8.1 



SET TERMINAL sets various attributes of your terminal. Privileged 
users can set attributes for any terminal. 

SET TERMINAL [:ttnn:]/gual if ier [s] 

Command Qualifiers 

Group 1: Common Use 

/DCL 

/[NO]HOLD_SCREEN !Not for VTlOOs 

/[NO] LOWERCASE 1/NOLOWER same as /UPPER and is 

/MCR 'default. 

/[NO] PRIVILEGED "Privileged 

/SPEED: (transmit , receive) 'Remember to set hardware after this 

! command. 
/[NO] UPPERCASE I/NOUPPERCASE same as /LOWERCASE 

/WIDTH :n 
/[NO] BROADCAST 
/CLI :cliname 

Group 2: Terminal Setup 

/[NO]AUTOBAUD 

/ASR33 

/ASR35 

/CRFILLrn !n can be 0-7 

/[NO]FORM_FEED 

/[NO]HARDCOPY 

/KSR33 

/KSR35 

/LAI 2 

/LA30P 

/LA30S 

/LA34 

/LA36 

/LA38 

/LA100 

/LA120 

/LA180S 

/LFFILL 

/[NO] SCOPE 

/[NO] TAB 

/MODEL :arg 

/PAGE_LENGTH:n 

/VT05 

/VT50 

/VT52 

/VT55 

/VT61 

/VT100 

/VT101 

/VT102 

/VT105 

/VT125 

/VT131 

/VT132 

/WIDTH :n 
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Group 3: Task Setup 

/[NO] ECHO 
/[NO]EIGHT_BIT 
/[NO] ESCAPE 
/[NO]FULL_DUPLEX 
/[NO] INTERACTIVE 
/[NO] LOCAL 
/[NO]PASSALL 
/[NO] REMOTE 
/[NO] SERIAL 

/[NO] SLAVE 
/[NO]TYPEAHEAD[:n] 

/[NO] WRAP 



■/NOSERIAL is default. 
I RSX -1 1M-PLUS on iy , 

•Numerical argument is RSX-11M-PLUS 
'only; n can be 0-255. 



SHOW ACCOUNTING 



Section 3,1.4.1 



SHOW ACCOUNTING displays curre.it information on your terminal session, 
if you are nonpr iviieged. Privileged users can display information 
about any terminal session. RSX-11M-PLDS only. 



SHOW ACCOUNTlNG/qualiiier 
Command Qualifier 



/INFORMATION 

/TRANSACTIONS [: LnfiieJ outf ile 



SHOW ASSIGNMENTS 



Section 5.10.1 



SHOW ASSIGNMENTS displays at your terminal your local and login 
logical-device assignments. Privileged users can display assignments 
from other terminals and global assignments. 



SHOW ASSIGNMENTS [/qualifier [s] ] 

Command Qualifiers 

/GLOBAL 

/LOCAL 

/LOGIN 

/SYSTEM 

/TERMINAL :ttnn: 



IPrivileged 

! Default 

ISame as /LOCAL 

! Synonym for /GLOBAL; privileged, 

[Privileged. 
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SHOW CLOCK QUEUE Section 7.12.9 



SHOW CLOCK_QUEUE displays information about tasks currently in the 
clock queue. This information consists of the task names, the next 
time each task is to run, and each task's reschedule interval, if any. 

SHOW CLOCK QUEUE 



SHOW COfflftOH Sec t i on 7,12.10' 



SHOW COMMON displays the names of resident commons installed in the 
system, their PCB addresses, the number of: attached tasks, and 5. he 

status of .. the common . , ■ ' > ■ '•";;\: . ' ■'■*,• ' . ' ' . ■ " ■- " U[ " :[ 

SHOW COMMON [: name] [,/qual if ier] ! No common name displays 

;;^ :. '" ; ::""., "":";;; : - '■"',. ; --■ """": ; '■- ; '".''"_ ""'.,, * ■■■;:;:, / i a n cODttioas; RSX-11M- PLUS only . 

Command Qua 1 i f i er "' : ; . - : - ; .-,,.., ' - : ' ■ " ■ " ' ■■■ ' " - . V" : "; ;; 

/TASK 'Displays tasks attached to a named 



SHOW [DAT] TIME Section 8.1.2 

SHOW [DAY] TIME displays the system time and date setting. 
SHOW [DAY] TIME 

SHOW DEFAULT Section 4.5.2 



SHOW DEFAULT displays the current default device and UFD for your 
terminal, along with your terminal number. 



SHOW DEFAULT 



SHOW DEVICES Section 5.10.3 



SHOW DEVICES displays information about the devices included in the 

system. 

SHOW DEVICES [/qual if ier] ! Two-character mnemonic only 
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Command Qualifiers 

/dd[nn:] 

/[NO] PUBLIC 

/WIDTH:ddnn: 

/[NO] SYSTEM ! Synonym for /PUBLIC 



SHOW GRODPFLAGS Section 6.6.2 



SHOW GROUPFLAGS displays the group global event flags currently in the 
system. 

SHOW GROUPFLAGS 



SHOW LIBRARY 7* ' "■■■■■.;, ""■':/; '-■."!:,.;. '" - ^Z/':'Z : -'"U."': ' ."■',,; ":'~ : " : 7''; : ;; - Section 8 .1.7 

SHOW LIBRARY displays the current. RSX-11M-PLUS library UFD. This is 
the (JFI) where the nonpr ivileqed system utilities are kept. 

SHOW Ll-BRARY-l-/<3ual-i-£J-er-J- '-"-- - ■ - ■— --"- 

Command Qual i f ier :. :: :■■,;-,;■'" ■ :■':' : i ,; f';J, 'W. ' J : ';. .^ , \ '";;,/' '■. :* .''/i.- / ;:* .;L;;:/ " ; ** ^ %.i d . ""s- ■: ,7*,: ■ 

/DIRECTORY / ; " : '"■.>„-;;./ <■;;■• 'V.: "No-op, "'*■;.■ "'.U: "' :"^:', r" "%■, "" '-■ 1, ■■*' 

SHOW MEMORY Section 8.1.9 



SHOW MEMORY invokes the Resource Monitoring Display (RMD) , a dynamic 
display of the system's activities in memory. 

SHOW MEMORY 



SHOW PARTITIONS Section 7.12.2 



SHOW PARTITIONS displays address and content information about the 
partitions in the system. You can display information about all 
partitions or about a single partition. 

SHOW PARTITIONS [: name] 
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SHOW PROCESSOR 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual, 



SHOW PROCESSOR displays information about the processors, batch 

processors, printers, card readers, and other devices under control of 

the Queue Manager. Batch processing is available on RSX-11M-PLUS 
only. 



SHOW processortype processorname 
Processortypes : 



CARD_READER 
DEVICE 

INPUT 
BATCH 

PRINTER 

PROCESSOR 



! INPUT is synonym. 

!A11 nonbatch output processors; 

isynonym for PRINTER. 

!CARD_READER is synonym. 

2A11 batch processors; RSX-11M-PLUS 

lonly. 

!A11 nonbatch output processors; 

Isynonym for DEVICE. 



SHOW QUEUE 

See the RSX-llM/M-PLUS Batch and Queue Operations Manual . 

SHOW QUEUE displays information about batch and print jobs in queues. 
Batch processing is available on RSX-11M-PLUS only. 



SHOW QUEUE [/qualifier] [queuename] 
Command Qualifiers 



/ALL 
/BATCH 

/BRIEF 
/DEVICE 
/ENTRY :n 
/FILES 

/FORMS : n 

/FULL 

/NAME: jobname 

/OWNER_UIC: [ [g,m] ] 

/PRINTER 



!A11 entries in all queues 

!A11 entries in all batch queues; RSX-11M-PLUS 

ionly. 

!A11 nonbatch queues; synonym for /PRINTER. 

ILists files in each job; not as long 
las /FULL. 



ILists only jobs with that name; may 

1 no my~\ it £?% ^ V> =i r\ r*«/% 
• t~**^ III V 4_ *i LltUll V^UC • 

JLists only jobs from that UIC; 

'default UIC is login UIC. 

!A11 nonbatch queues; synonym for 

I/DEVICE. 
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SHOW SYSTEM 



Section 8.1.6 



SHOW SYSTEM displays information about the current system. 



SHOW SYSTEMf/gualifier] 

Command Qualifiers 

/CLI 

/DIRECTORY 
/EXTENSION_LIMIT 
/PACKETS 

/POOL 
/SECONDARY POOL 



ICLIs on current system 

IDefault; displays current system UFD. 

ITask extension limit 

! Maximum I/O packets and number 

Jcurrently available. 

IDisplays pool statistics. 

lKhow-3 secondary poo 1 (RSX-- 1 JM-PLOS only) 



SHOW TASKS 



Section 7.12.3.1 
7.12.3.2 



SHOW TASKS displays information about active or installed tasks, 



SHOW TASKS [:taskname] /qualifier [s] 
Command Qualifiers 



/ACTIVE [tttnn:] 

/INSTALLED 

/LOGICAL_UNITS 

/BRIEF 

/FULL 

/ALL 



[Static LUNs for installed task 
Iqualif ier . 



SHOW TASKS/DYNAMIC 



Section 7.12.3.3.1 
7.12.3.3.2 



SHOW TASKS/DYNAMIC invokes RMD to display on a video terminal 
continuing changes in either a single task header or of all or part of 
the Active Task List. On a hard-copy terminal, SHOW TASKS/DYNAMIC 
provides a snapshot display. See main text for more information. 



Format to display individual task information 

SHOW TASK: taskname/DYNAMIC [/qualifier] 
Command Qualifier 

/RATE:n IRate in seconds for display change; default n=l. 
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Format to display Active Task List 

SHOW TASKS/ACTIVE/DYNAMIC [/qualifier [s] ] 

Command Qualifiers 

/OWNER:ddnn: iDefault is ALL. 

ALL 

/PRIORITY:n IHighest priority to display; default n=250. 

/RATErn 'Rate in seconds for display change; default n=l. 



SHOW TERMINAL Section 3.8.2 



SHOW TERMINAL displays information about your terminal and other 
terminals on your system. 

SHOW TERMINAL [:ttnn:] [/qualifier] 'Without qualifier, displays all 

lattributes of the terminal; 
Jdefault ttnn:=TI:. 

Command Qualifiers 

/[NO]AUTOBAUD 

/[NO] ASR33 

/[NO] ASR35 

/[NO] BROADCAST 

/CLI :cliname 

/[NO]CRFILL 

/DCL 

/[NO] ECHO 

/[NO]EIGHT_BIT 

/[NO] ESCAPE 

/[NO]FORM_FEED 

/[NO]FULL_DUPLEX 

/[NO]HARDCOPY 

/[NO]HOLD_SCREEN 

/HT IDECnet host terminal 

/[NO] INTERACTIVE 

/[NO]KSR33 

/[NO]KSR35 

/[NO]LA12 

/[N0]LA24 

/[NO]LA30P 

/[NO]LA30S 

/[NO]LA34 

/[NO]LA36 

/[NO]LA38 

/ r m.-» /\ T r ■fclfvrt 

/ |_WUJ LiHlUU 

/[NO]LA120 

/[NO]LA180S 

/[NO]LFFILL 

/[NO] LOCAL 

/LOGGED_ON 

/[NO] LOWERCASE ! NOLOWER same as /UPPER and is 

'default. 
/MCR 
/MODEL 

/PAGE_LENGTH 
/[NO]PASSALL 
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/[NO] PRIVILEGE 

/[NO] REMOTE 

/[NO] SCOPE 

/[NO] SERIAL 

/[NO] SLAVE 

/SPEED 

/[NO] TAB 

/TI: !A11 real terminals 

/TT 

/[NO]TYPE_AHEAD !/NO UPPERCASE same as /LOWERCASE. 

/[NO] UPPERCASE 

,'VT: IViitunl tOL-ninal; PSX- I !M-1 J L'JS only. 

/[NO]VT05 

/[NO]VT50 

/[NO]VT52 

/[NO]VT55 

/[NO]VT61 

/[NO]VT100 

/[NO]VT101 

/[NOJVT102 

/[NO]VT105 

/[NOJVT125 

/[NO]VT131 

/[NO]VT132 

/WIDTH 

/[NO] WRAP 



SHOW USERS Section 8.1.8 



DECnet host terminals and virtual terminals, with the default UFD and 
login UIC for each. 

SHOW USERS 



SORT Section 4.4.4 

SORT invokes the SORT-11 utility, if present. See main text. 
SORT[/KEY: (abm.n) [abm.n...]] [/qualifier [s] ] inf i le [/qual] outfile FORMAT: (arg) [/qua 1] 

Command Qualifiers 

/ALLOCATION: n 
/BUCKET_SIZE:n 
/[NO] CONTIGUOUS 
/DEVICErddnn: 
/PROCESS: type 

ADDRESS_ROUTING 

INDEX 

RECORD 

TAG 
/SIZE:n 

/SPECIFICATION: f ilespec 
/WORK FILES:n 
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File Qualifiers 

/BLOCK_SIZE:n 
/FORMAT: (format, [n] ) 

FIXED :n 
STREAM:n 
UN KNOWN :n 
VARIABLE:n 

/INDEXED :n 

/RELATIVE 

/SEQUENTIAL 



Unfile or outfile 

'Required on infile; may appear on 

loutfile; n is size in bytes. 



Unfile 

•Outfile 

•Outfile 



START 



Section 7.7 



START resumes execution of a task stopped by a STOP$S directive. 

START [/qualifier ] [taskname] !Taskname defaults to TTnn. 

Command Qualifier 

/TERMINAL:ttnn: IPrivileged 



START/PROCESSOR 

See the RSX-11M/M-PLUS System Management Guide . 



START/PROCESSOR starts a processor, batch processor, output processor, 
or card-reader processor. Privileged. 



START/processortype processorname[/qualif ier [s] ] 
Processortypes : 



APPLICATIONS_PROCESSOR 

BATCH_PROCESSOR . 

CARD_READER 

DEVICE 

INPUT 

PRINTER 

PROCESSOR 



Command Qualifiers 

/FORMS :n 

/CONTINUE 

/RESTART 

/NEXT 

/TOP_OF_FILE 

/BACKSPACE :n 

/FORWARDSPACE'.n 

/PAGE:n 

/ALIGN 



! INPUT is synonym. 
•PRINTER is synonym. 
ICARD_READER is synonym. 
IDEVICE is synonym. 



! Overrides value set on 
! initialization. 
•Default 



9-43 



QDICK REFERENCE 



START/QDEUE 

See the RSX-11M/M-PLUS System Management Guide, 



START/QUEUE starts a queue. Privileged. 
START/QUEUE queuename 



START/QOEUE/MANAGER 

See the RSX-11M/M-PLUS System Management Guide . 

START/QUEUE/MANAGER starts the Queue Manager. Privileged. 
START/QUEUE/MANAGER 

START/OHBLOCK Section 7.7.1 



START/UNBLOCK continues the execution of a task blocked by the 
STOP/BLOCK command. Nonprivileged users can unblock any task running 
from their own terminal. Privileged users can unblock any task. See 
main text. 

START/UNBLOCK [/qual i f ier ] [ taskname] 



C&sw& nd Qo a 1 i f i 6 * 

/TKKMlNALsctnn: - - IPrivilegod; RSX-llM-PLUS only. 



STOP/ABORT 

See the RSX-11M/M-PLUS Batch and Queue Operations Manual . 

STOP/ABORT stops the current job on a line printer immediately. 
Privileged users can stop any job. Nonprivileged users can stop their 
own jobs. 

STOP/ABORT printer [:] 
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STOP/BLOCK Section 7.6 



STOP/BLOCK blocks an installed running task. The task no longer 

executes or competes for memory. Nonprivileged users can block tasks 

running from their own terminals. Privileged users can block any 
task. See main text. 

STOP/BLOCK [/qualifier] [taskname] 

Command Qualifier 

.'THKMi'lA:.: ttiin: ' '. l 'r : v : Lorjc-.l ; R.VX-lLM-I'Ll'W only. 



STOP/PROCESSOR 

See the RSX-llM/M-PLUS System Management Guide . 

STOP/PROCESSOR stops a processor, batch processor, card-reader 
processor, printer, or other output processor. Privileged. 

STOP/processortype processorname [/qualifier [s] ] 

Processortypes : 

APPLICATIONS_PROCESSOR 

B ATCH_PROCESSOR . 
CARD_READER ! INPUT is synonym. 
DEVICE ! PRINTER is synonym. 
INPUT !CARD_READER is synonym. 
PRINTER i DEVICE is synonym. 
PROCESSOR 

Command Qualifiers 

/ABORT !See main text 

/FILE_END 

/JOB_END 

/PAUSE 



STOP/QUEUE 

See the RSX-llM/M-PLUS System Management Guide . 

STOP/QUEUE stops queues. Privileged. 
STOP/QUEUE queuename 
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STOP/QUEUE/MANAGER 

See the RSX-11M/M-PLUS System Management Guide , 



STOP/QUEUE/MANAGER stops the Queue Manager. Privileged, 



STOP/QUEUE/MANAGER 
Command Qualifier 
/ABORT 



[Marks QMG for stop after current job, 



! Stops QMG immediately. 



SOBM I T , ■ ■ ■ ■■ ' „ - ■ ■* : - " . . ■■ ■' ' „ * ; ■ ' ■ 

See the R SX-LIM/M-PLU S Patch and Queue Operations Manual , 



SUBMIT queues QMG batch jobs consisting of one or more user batch iobs 
for. processing by a batch processor. R3X-11M-PLUS only. 



SUBM 1 t [ /qua 1 i !." ier [ s ] ] £ i lespec [ s ] 



Comma : i d Q u a 1 i f i e r s 

/AFTER: (dd-mmm-yy hhtmm) 
/[NO] DELETE . ', ] ■ : 

/[NO] HOLD 

/[NO]LOG_FILE 
/NAME: jobname 

/ [NO] PRINTK t f :q jeuen ■■.■?. .■; 
/PRIORITY:n 

/QUWUK :queuenaioe 
/[NO] RESTART 
/[NO] TRANSFER 



! Deletes batch File after run? command 
lot fi lespec qualifier. 
[Default is /NOHOLD; /HOLD has same 
!ftffi-*c:t as HOT.n f-rxrsrinrsd . 

! L-9 characters; default is first 

1 f i 1 cnamo . 

[Optionally name queue tor log print job 

m is i-i-bO tionprivi Legcd; through 250 

[privileged; default n=50. 



TYPE 



Section 4.4.1 



TYPE prints selected files on your terminal. 



TYPE [/qualifier [s] ]filespec[s] 
/DATE: dd-mmm-yy 
/SINCE:dd-mmm-yy 
/THROUGH :dd-mmm-yy 
/SINCE: dd-mmm-yy 
/TODAY 
/EXCLODE:filespec 



[Given day only 

[From given day through current day 
[From beginning through given day 
[From given day through given day 
•Today only 

JFilespec can include wildcards. 
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UNFIX 



Section 7.11 



UNFIX frees a fixed task or region from memory. Privileged, 



UNFIX [/qualifier] taskname 
Command Qualifiers 
/READONLY_SEGMENT 

/REG I OS 



!Can be region name. 



!RO segment of multiuser 
•task; RSX-11M-PLUS only. 
■ RSX- ] 1 H- PLUS on! y . 



UNLOCK 



Section 4.4.6 



UNLOCK unlocks locked files. Locked files are files that have been 
improperly closed. They are identified by an L in the directory 
listing. 



UNLOCK [/qualifier [s] ] filespec[s] 

Command Qualifiers 

/DATE : dd-mmm-yy 

/S INCE : dd-mmm-yy 

/THROUGH : dd -mmm-yy 

/SINCE: dd -mmra-yy/THROUGH : dd -mmm-yy 

/TODAY 

/EXCLUDE: filespec 



IGiven day only 

SFrom given day through current day 

IFrom beginning through given day 

IFrom given day through given day 

! Today only 

IFilespec can include wildcards. 
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COMMON ERROR MESSAGES 



The following error messages are common to many DCL commands. They 
may appear on your terminal preceded by a 3-letter code identifying 
the system component that detected the error. This can be DCL or the 
first three letters of the command itself. This code appears here as 

yyy- 

Most of the error messages with the word "expected" in them reprint 
the command on your terminal with a circumflex (*) pointing to the 
error. Sometimes the circumflex points to the character just past the 
last successfully parsed command element. 

Many of the explanations refer to the Radix-50 character set. The 
Radix-50 characters are the uppercase alphabet, the numerals through 
9, the dollar sign ($) , and the period (.). 

Many other error messages are included in the descriptions of the 
commands that produce the errors. Many system tasks also issue error 
messages. These messages are explained elsewhere in the documentation 
set. In particular, many I/O errors return error messages as code 
numbers. These errors are explained in the system Mini-Reference and 
are discussed further in the I/O documentation. The RSX-llM/M-PLUS 
MCR Operations Manual and the RSX-llM/M-PLUS Utilities Manual also 
contain explanations of many errors. 

yyy -- Allocation failure - no contiguous space 

Explanation: Not enough contiguous space is available on the 
output volume for the file being copied. 

User Action: Delete any files no longer required on the output 
volume and retry the command. You may need to use the BACKUP 
command or the DSC utility to compress the files on the output 
disk. 

yyy — Allocation failure on output file 

or 

yyy -- Allocation failure -- no space available 

Explanation: Not enough space is available on the output volume 
for the file being copied. 

User Action: Delete any files no longer required on the output 
volume and retry the command. You may need to use the BACKUP 
command or the DSC utility to compress the files on the output 
disk. 
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yyy -- A-Z expected 

Explanation: The command as typed included a nonalphabetic 
character. 

User Action: Check command for proper syntax and reenter. 

yyy -- A-Z and/or 0-9 expected 

Explanation: The command as typed included a nonalphanumeric 
character . 

User Action: Check command for proper syntax and reenter. 

yyy -- Ba ^ error message 

Explanation: Some unusual condition has caused an error. 

User Action: Notify your operator or system manager and make 
ready to send in a Software Performance Report (SPR) . Record the 
command that caused the error and other information on activity 
at your terminal at the time. 

yyy -- Bad use of wild cards in destination file name 

Explanation: A wildcard (*) was specified for an output file 
where it is not permitted. 

User Action: Reenter the command with a complete and explicit 
file specification for the output file. 

yyy — Cannot find directory file 

Explanation: The command specified a UFD not found on the 
current volume. 

User Action: Reenter the command after checking for the correct 
UFD and correct volume. 

yyy — Cannot find files 

Explanation: The file or files specified in the command are not 
in the designated directory. 

User Action: Check the file specification and reenter the 
command line. 

yyy — Cannot rename from one device to another 

Explanation: The command attempted to rename a file across 
devices . 

User Action: Use the COPY command to move the file from one 
device to another and rename it. 

yyy — Cannot truncate this filetype 

Explanation: The command attempted to truncate a file that 
cannot be truncated. Only files containing fixed-length, 
variable-length, or sequenced records can be truncated. 

User Action: Check to see if you have named the proper file and 
retry the command. 
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yyy __ close failure on input file 

or 

yyy — Close failure on output file 

Explanation: A file named in the command could not be properly 
closed. The file is locked by PIP. 

Dser Action: Use UNLOCK to unlock the file. Determine the cause 
of the error and correct it if you can. You may need to check 
the validity of the file structure with the VFY utility. 

yyy — Command function not unique 

Explanation: The command as typed did not include sufficient 
characters to identify some command function. 

User Action: Retype command after checking proper syntax, 
yyy — Command line incomplete 

Explanation: The command as typed is not a complete command. 

Dser Action: Retype command after checking proper syntax, 
yyy — Command syntax error 

Explanation: The command did not conform to the syntax rules. 

User Action: Check command for proper syntax and reenter it. 
yyy — Conflicting qualifier 

Explanation: The command as typed included qualifiers that 
conflict with each other in their effect. 

User Action: Retype command after checking proper syntax. 

yyy — Contradictory qualifier 

Explanation: The command as typed included contradictory 
qualifiers, such as /DELETE and /NODELETE. 

User Action: Check for proper syntax and reenter command. 

yyy — Contradictory qualifier in key specification 

Explanation: The command included a contradictory qualifier in 
the key definition argument to the /KEY qualifier. 

User Action: Check command for proper syntax and reenter. 

yyy -- Decimal number expected 

Explanation: The command included a number not in proper format. 

User Action: Check command for proper syntax and reenter with a 
decimal point (.) terminating the number. 
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yyy -- Device invalid or not specified 

Explanation: The command specified an invalid device or no 
device at all when a device name is required. 

User Action: Check the devices on the system with SHOW DEVICES. 
Reenter command after checking for proper syntax. Determine the 
cause of the error and correct it if you can. If you cannot, see 
your operator or system manager. 

yyy — Device not in system 

Explanation: The command specified a device that is not in the 
current system. 

Dser Action: Check the devices on the system with SHOW DEVICES. 
Reenter command after checking for proper syntax. 

yyy — Device not mounted/allocated 

Explanation: The command specified a device that is not properly 
mounted or allocated for the command to execute. 

User Action: Check the status of the device with SHOW DEVICES. 
Find the cause of the error and correct it if you can. It is 
likely that you will need to mount the volume on the device. 
Nonprivileged users need the volume label to mount the volume. 

yyy - Device not terminal 

Explanation: The command specified a device other than a 
terminal where a terminal device name is required. TI: is not 
an acceptable terminal device name in all contexts. 

user Action: Reenter the command after checking for proper 
syntax. 

yyy — Directory write protected 

Explanation: The command attempted to remove an entry from a 
directory that is privileged or from a directory on a device that 
is write-protected. 

User Action: Determine the cause of the error and correct it if 
you can. You may need to enable write access through the device 
hardware or change the protection for the directory. If you 
cannot correct the error, see your system manager or operator. 

yyy — Error dispatching command. DSW = 'n' 

Explanation: An error occurred that was not explicitly handled 
by DCL or some invoked task. 

User Action: Look up the DSW error code in the Mini-Reference or 
the RSX-11M/M-PLUS Executive Reference Manual . Determine the 
cause of the error and correct it if you can. If you cannot, see 
your system manager or operator. 

yyy — Explicit output file name required 

Explanation: The command requires an explicit output file name. 

User Action: Reenter the command line in proper syntax and 
without wildcards. 
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yyy — Extraneous input 

Explanation: The command as typed included extraneous input, 
The circumflex (~) points to the error or just past the last 
successfully parsed command element. 

User Action: Reenter the command line in proper syntax, 
yyy — Failed to attach output device 

or 

yyy — Failed to detach output device 

Explanation: An attempt to attach or detach a record-oriented 
output device, such as a terminal or line printer, failed. This 
error usually means the device is off-line or nonresident. 

User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 

yyy -- Failed to create output UFD 

Explanation: The command failed to create an entry in a 
directory because the device was write-protected or because of a 
privilege violation. 

User Action: Determine the cause of the error and correct it if 
you can. You may need to enable write access through the device 
hardware or change the protection for the directory. If you 
cannot correct the error, see your system manager or operator. 

yyy — Failed to delete file 

or 
yyy — Failed to mark file for delete 

Explanation: The command attempted to delete a protected file. 

User Action: Check for the proper file specification and default 
UFD and reenter the command. You may need privilege to delete 
the file. 

yyy -- Failed to enter new filename 

Explanation: The command specified a file that already exists in 
the UFD, or the directory is protected. 

User Action: Check for proper syntax and reenter the command. 

yyy — Failed to find files 

not be found as specified. 

User Action: Check for proper file specifications and reenter 
the command. 
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yyy — Failed to get time parameters 

Explanation: An internal system problem has occurred. 

User Action: Retry the command. If the error recurs, see your 
system manager and prepare to submit a Software Performance 
Report. Record the command that caused the error and other 
information on activity at your terminal at the time. 

yyy — Failed to read attributes 

Explanation: The command specified a volume that is either 
corrupted or protected against access. 

User Action: You may be able to correct the error by making your 
defaults the same as the device and UFD of the file you wish to 
affect. You may need to check the validity of the volume with 
the VFY utility. 

yyy — Failed to remove directory entry 

Explanation: The command attempted to remove an entry from a 
directory that was either protected against access or on a 
write-protected device. 

User Action: Determine the cause of the error and correct it if 
you can. You may need to enable write access through the device 
hardware or change the protection for the directory. If you 
cannot correct the error, see your system manager or operator. 

yyy — Failed to truncate file 

Explanation: The command specified a volume that is corrupted or 
is protected against access. 

User Action: You may be able to correct the error by making your 
defaults the same as the device and UFD of the file you wish to 
affect. You may need to check the validity of the volume with 
the VFY utility. 

yyy — Failed to write attributes 

Explanation: The command specified a volume that is corrupted or 
is protected against access. 

User Action: You may be able to correct the error by making your 
defaults the same as the device and UFD of the file you wish to 
affect. You may need to check the validity of the volume with 
the VFY utility. 

yyy — Fatal I/O error 

Explanation: The command failed to execute because of some I/O 
error. This error can be caused by the unavailability of a 
device or of pool space, or by a device error. The device may be 
write-locked. 

User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 
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yyy __ File is lost 

Explanation: PIP has removed a file from its UFD, failed to 
delete it, and failed to restore the directory entry. 

User Action: Use the VFY utility to run the lost-file check to 
recover the file name. 

yyy — Filename or filetype not specified 

Explanation: The command as typed did not clearly specify a file 
name and file type where one or the other or both is required. 
This error can be caused if you do not leave a space in front of 
a file specification that is a parameter. 

User Action: Retype command after checking for proper syntax. 

yyy — File not locked 

Explanation: An UNLOCK command specified a file that is not 
locked . 

User Action: Check for the proper file specification and reenter 
the command. 

yyy — File specification either invalid or not specified 

Explanation: The system could not read a file specification 
included in the command. This error often results from a typing 
mistake or typing the command in the wrong format. 

User Action: Check for proper syntax and reenter the command. 

yyy — File specification list not available for RMS-11 

Explanation: A command to an RMS-11 utility included more than 
one input file specification. 

User Action: Check for proper syntax and reenter command. 

yyy __ File version number not specified 

Explanation: The command requires a file version number to be 
specified. 

User Action: Reenter command after checking for proper syntax. 

yyy — Function not unique 

Explanation: The command as typed did not include sufficient 
characters to identify some function. 

User Action: Retype the command but include more characters. 

yyy — Get command line - Bad @ file name 

Explanation: The command specified an illegal indirect command 
file. 

User Action: Check for proper file specification and reenter the 
command . 
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yyy -- Illegal command 

Explanation: The command, which is the first word on the command 
line, is not part of DCL. 

User Action: Check command for proper syntax and reenter. If 
the command fails again, see your system manager. 

yyy — Illegal device 

Explanation: The command named a device in an illegal format or 
contained some other syntax error. 

Dser Action: Check command for proper syntax and reenter. 
Device names are two alphabetical characters followed by an octal 
number and a colon. 

YYY — Illegal filespec 

Explanation: The command required a file specification that was 
not present. 

User Action: Check command for proper syntax and reenter. See 
Section 4.1.2 for a complete description of a file specification. 
Perhaps some other command element is being parsed as a filespec. 
Use the prompting version. 

yyy — Illegal job name 

Explanation: A command to the Queue Manager named a job in an 
improper format. 

User Action: Check command for proper syntax and reenter. Job 
names include an optional UIC and as many as nine Radix-50 
characters. The -irsh n^mo is liaforl in t-Via ch<~it»7 nmrntr ^isni^.i 

yyy — Illegal or contradictory qualifier 

Explanation: One or more qualifiers to the command are in 
conflict, or are in error. 

User Action: Check command for proper syntax and reenter. 

yyy — Illegal processor name 

Explanation: A command to the Queue Manager named a processor in 
an improper format. 

User Action: Check command for proper syntax and reenter. 
Processor names include as many as six Radix-50 characters. 
Processor names are listed in the SHOW PROCESSOR display. 

yyy — Illegal protection code 

Explanation: The command specified a protection code in an 
improper format. 

User Action: Check command for proper syntax and reenter. See 
Section 4.1.5 for more information on protection codes. 
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yyy — Illegal qualifier value 

Explanation: The command as typed included an improper argument 
to a qualifier. 

Dser Action: Check command for proper syntax and reenter. In 
DCL, an argument is preceded by a colon (:). 

YYY — Illegal queue name 

Explanation: A command to the Queue Manager named a queue in an 
improper format. 

User Action: Check command for proper syntax and reenter. Queue 
names include as many as six Radix-50 characters. Queue names 
are listed in the SHOW QUEUE display. 

yyy — Illegal use of wildcard character 

Explanation: The command included a wildcard (* or %) in a file 
specification in a way that would result in unpredictable or 
inconsistent output. 

User Action: Check command for proper syntax and reenter. You 
may not be able to use the wildcard. 

yyy — Illegal task name 

Explanation: The command named a task using a task name in an 
illegal format. 

User Action: Check command for proper syntax and reenter. Task 
names include as many as six Radix-50 characters. 

yyy — Input device must be a directory device 

Explanation: The command as typed specified a device that is not 

a directory device, such as a line printer or magnetic tape. 

Directory devices are those on which Files-11 volumes with 
directories can be mounted. 

User Action: Correct syntax and reenter command. 

yyy — Input files have conflicting attributes 

Explanation: Warning message. The command operation completed, 
but the files named had conflicting attributes. 

User Action: Use DIRECTORY/ATTRIBUTES to find the attributes of 
all input and output files involved. Determine if the conflict 
causes any difficulty. 

yyy -_ Invalid command function 

Explanation: The command as typed requested a function that is 
not valid for that command. 

User Action: Check command for proper syntax and reenter it. 
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yyy — Invalid command parameter 

Explanation: The command as typed included a parameter that is 
not valid. In DCL, a parameter is either entered in response to 
a prompt or preceded by a space. 

Dser Action: Check command for proper syntax and reenter. 

YYY — Invalid file specification list 

Explanation: The command included a list of file specifications 
in an invalid format. In general, file specifications in lists 
should be separated by commas and, optionally, blanks. 

User Action: Retype command after checking proper syntax. 

yyy — Invalid file specification qualifier 

Explanation: The command included a qualifier to a file 
specification that was not valid. In DCL, a qualifier is 
preceded by a slash (/) . 

User Action: Check for proper syntax and retype the command. 

yyy — Invalid terminal specified 

Explanation: A command directed to a specific terminal named the 
terminal in an improper format. 

Oser Action: Check the name of the terminal using SHOW USERS and 
reenter the command with the proper format. 

yyy — Invalid time or date 

Explanation: The cotnmanH specified a clock or calendar field or 
both, incorrectly. 

User Action: Check for proper syntax and retype the command. 

yyy — Invalid UIC specified 

Explanation: The command specified a 0, a number including an 8 
or 9, or a number greater than 377 (octal) for the group or 
member number in a UIC or UFD. 

User Action: Retype command after checking for proper syntax, 
yyy — I/O error on input file 

or 
yyy — I/O error on output file 

Explanation: One of the following conditions exists: 

• The device is not on line. 

• The device is not mounted. 

• The hardware has failed. 

• The output volume is full. 

• The input file is corrupted. 



A-10 



COMMON ERROR MESSAGES 

Dser Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 

yyy — Key position size or number not specified 

Explanation: The command failed to include the size or number of 
a key position in the key definition argument to the /KEY 
qualifier . 

User Action: Check command for proper syntax and retype it. 

yyy __ Key specification out of sequence 

Explanation: The command included improper syntax in the key 
definition argument to the /KEY qualifier. 

User Action: Check command for proper syntax and reenter. 

yyy — Magnetic tape file label not specified 

Explanation: The command attempted to initialize a magnetic tape 
without specifying the required volume label. 

Dser Action: Retype command after you have checked for proper 
syntax. 

yyy — More command parameters than permitted 

Explanation: The command as typed included too many parameters. 

User Action: Check command for proper syntax and reenter, 
yyy — No such file 

Explanation: The command requested operations on a file that 
does not exist. 

Dser Action: Make sure you have named the file properly. Check 
your defaults to be sure you are looking in the right UFD on the 
right device. You may have made a typing error. If the desired 
file is in fact not present, find out why it is not present and 
proceed accordingly. 

yyy -- Not a directory device 

Explanation: A directory-oriented command named a device that 
does not have directories, such a line printer. 

User Action: If you can, reenter the command without specifying 
a UFD. 

yyy — Not logged in 

logged in. 

User Action: Only LOGIN, HELLO and HELP execute on terminals 
that are not logged in. If you do not know how to log in, type 
HELP. If you know how to log in, do so and reenter the command. 
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yyy -- Numeral expected 

yyy -- Numeral required 

Explanation: Command included nonnumeric characters in a 
position where numerals are required or expected. 

User Action: Check command for proper syntax and reenter. 

yyy — Octal number expected 

Explanation: The command included a number with an 8 or 9 where 
an octal number was expected. 

Oser Action: Check command for proper syntax and reenter. 

yyy — Open failure on file 

Explanation: The system could not open a required file for some 
reason. 

Oser Action: Check the UFD to be sure that the file is present, 

not locked, and in the proper format. If the file is locked, it 

may be corrupted or contain bad data. Determine the cause of the 

error and correct it if you can. If you cannot, see your 
operator or system manager. 

yyy — Output device must be a directory device 

Explanation: The command as typed specified a device that is not 
a directory device, such as a line printer or magnetic tape. 
Directory devices are those on which Files-11 volumes with 
directories can be mounted. 

Oser Action: Correct syntax and reenter command. 

yyy — Partition busy 

Explanation: The partition into which a task was to be fixed was 
occupied by a running task. The requested task thus could not be 
fixed. 

Oser Action: Wait until the partition is no longer busy or find 
out why the partition is busy and proceed accordingly. 

yyy — Primary key not specified 

Explanation: A command affecting an indexed file failed to 
include a primary key. In many such commands, you cannot specify 
any action on an alternate key without first identifying the 
primary key. 

Oser Action: Check for proper syntax and reenter command. 

yyy — Privilege violation 

Explanation: The command was a privileged command issued at a 
nonprivileged terminal. 

Oser Action: None. If you must have the function requested, 
find a privileged user to issue the command for you. 
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yyy — Qualifier inconsistent with compiler 

Explanation: A compiler command included a qualifier not 
acceptable by that compiler, such as a F0RTRAN/F4P command 
including a /LINE_NUMBERS qualifier, which is for the FOR 
compiler only. 

User Action: Check the command for proper syntax and try it 
again. Remember that your command may be specifying a compiler 
by default. 

yyy — Qualifier not available for this command format 

Explanation: The command included a qualifier that is invalid in 
the current context of the command. The context is usually 
determined by some other qualifier in the command. 

User Action: Reenter command after checking for proper syntax. 

yyy — Qualifier not unique 

Explanation: The command as typed did not include sufficient 
characters to identify some qualifier. In DCL, qualifiers are 
preceded by a slash (/) . 

User Action: Retype the command, but include more characters. 

yyy — Qualifier value invalid here 

Explanation: The commands as typed included ah inappropriate 
argument to a qualifier. In DCL, an argument is usually preceded 
by a colon ( : ) . 

User Action: Check command for proper syntax and reenter. 

yyy -- Radix-50 expected 

Explanation: The command included a non-Radix-50 character where 
Radix-50 required. 

Oser Action: Reenter the command using proper syntax. The 
Radix-50 characters are the uppercase alphabet, the numbers 
through 9, the dollar sign ($) , and the period {.). 

yyy -- Repeated command parameter 

Explanation: The command as typed included one parameter more 
than once. In DCL, a parameter is preceded by a blank or prompt. 

Oser Action: Retype command after checking for proper syntax. 

yyy — Repeated key specification 

Explanation: The command as typed included the same key 
specification more than once in the key definition argument to 
the /KEY qualifier. 

Oser Action: Retype command after checking for proper syntax. 

yyy — Repeated keyword in key specification 

Explanation: The command as typed included the same keyword more 
than once in the key definition argument to the /KEY qualifier. 

Oser Action: Retype command after checking for proper syntax. 



A-13 



COMMON ERROR MESSAGES 

yyy — Repeated magnetic tape file label 

Explanation: The command included the required volume label more 
than once. 

User Action: Check command syntax for correctness and reenter 
the command. 

yyy — Repeated qualifier 

Explanation: The command specified the same qualifier more than 
once. In DCL, a qualifier is preceded by a slash {/) . 

User Action: Reenter command after checking the syntax to see if 
it is right. 

yyy — Required parameter not specified 

Explanation: The command cannot execute without required 
parameters, such as a file specification or attribute. In DCL, a 
parameter is preceded by a blank or prompt. 

User Action: Retry the command, using the prompts. DCL prompts 
for all required parameters. 

yyy — Required qualifier not specified 

Explanation: The command requires a qualifier that it does not 
include. In DCL, a qualifier is preceded by a slash (/) . 

User Action: Check for proper syntax and reenter the command. 

yyy — Required qualifier value not specified 

Explanation: A qualifier to tne command requires that you state 
a numerical argument. In DCL, an argument is usually preceded by 
a colon ( : ) . 

User Action: Retype command after checking for proper syntax. 

yyy — Required value not specified for position size or number 

Explanation: The command failed to include a required value in 
the key definition argument to the /INDEXED qualifier. 

User Action: Check command for proper syntax and reenter. 

yyy — Sorry, line too long 

Explanation: DCL commands are translated for execution by MCR or 
another system task or utility. This error is caused by a 
translated command line that the destination task cannot handle. 

User Action: Check command syntax to see if you are specifying 
elements that can be defaulted. Check to see if you can enter 
the command twice with different qualifiers to accomplish in two 
commands what you cannot accomplish in one. You may have to 
enter the command in MCR format or the format of the task or 
utility you are seeking to invoke. Check the translated command 
line with SET DEBUG. 
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yyy -- Sorry, "-" not supported in Indirect 

Explanation: An indirect command file included an illegal 
element, as identified by the quoted part of the message. 

Dser Action: Check indirect command file for correctness. 

yyy — Sorry, low pool 

Explanation: The command could not execute because of 
insufficient space in the system pool (dynamic storage region) . 

Dser Action: The pool is the Executive's data base. In general, 
each task, including commands, uses a certain amount of pool. If 
the pool is full or badly fragmented, there may not be sufficient 
space for the command to execute. Usually, pool problems clear 
up spontaneously if you wait. 

Retry the command after an interval. If it still does not 
execute, see your operator or system manager. You should not 
attempt to execute any other task, not even an ABORT or LOGOUT, 
when the pool is low. These tasks too absorb pool. 

yyy — Sorry, task active 

Explanation: The command required some action that cannot be 
taken on an active task. 

User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your system manager or operator. 
Check the task with the various SHOW TASK commands, or SHOW 
MEMORY. 

yyy — Sorry, task not installed 

Explanation: The command attempted to invoke a task that was not 
installed. 

User Action: Try running the task with a command in the RUN $ 
form. Determine the cause of the error and correct it if you 
can. If you cannot, see your system manager or operator. 

yyy — Syntax error 

Explanation: The command included some error in typing or 
specification, such as a letter where a number should appear. 

User Action: Check for proper syntax and reenter command. 

yyy — Version must be explicit or "*" 

Explanation: The command syntax requires that the version number 
of the file must be specified explicitly or as a wildcard ( * ). 

Dser Action: Reenter the command with the version number 
correctly expressed. 

yyy — Wildcards not permitted 

Explanation: Command included a wildcard (* or %) in a context 
where it is not permitted. 

User Action: Check for proper syntax and reenter command. 
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COMMON ERROR MESSAGES 



yyy __ zero value not valid for key size or number 

Explanation: The command included a zero value in the key 
definition argument to the /KEY qualifier. 

User Action: Check command for proper syntax and reenter. 
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APPENDIX B 
FUNCTIONS INITIATED BY DCL COMMANDS 



Most DCL commands initiate functions that are actually performed by 
MCR or by some other system task or utility. The following table 
gives these relationships, with any necessary comments. 



DCL Command 



MCR Command, 
Task, or Utility 



Comments 



ABORT 

ALLOCATE 

APPEND 

ASSIGN 

ASSIGN/QUEUE 

ASSIGN/REDIRECT 

ASSIGN/TASK 

BACKUP 

BASIC 

BROADCAST 

CANCEL 

COBOL 

CONTINUE 

CONVERT 

COPY 

CORAL 

CREATE 

CREATE/DIRECTORY 

DEALLOCATE 

DEASSIGN 



ABORT 

ALLocate 

PIP 

ASsigN 

QMG 

REDirect 

REAssign 

BRU 

BAS, BP2 

BROadcast 

CANcel 

COB 

RESume 

RMS CNV 

PIP 

COR 

PIP, FCS 

UFD 

DEAllocate 

ASsigN 



Assign logical name 

Assign queue to 
processor 

Redirect device 

Alter LUN assignments 



DS3SS1QP 10 rT lC3l r» a m^ 
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FUNCTIONS INITIATED BY DCL COMMANDS 



DCL Command 



MCR Command, 
Task, or Utility 



Comments 



DEASSIGN/QUEUE 

DEBUG 

DELETE 

DELETE/ENTRY 

DELETE/JOB 

DELETE/PROCESSOR 

DELETE/QUEUE 

DIFFERENCES 

DIRECTORY 

DISMOUNT 

EDIT 

FORTRAN 

FIX 

HELP 



QMG 

DEBug 

PIP 

QMG 

QMG 

QMG 

QMG 

CMP 

PIP 
RMS DSP 

DisMOunt 

EDT, EDI, KED, SLP 

FOR, F4P, F77 

FIX 

HELlO 



Eliminate assignment of 
queue to processor 



Delete files 



Delete despooler task 
Delete queue 

/ATTRIBUTES qualifier 



As part of HELlo, HELP 
can run on unlogged-on 



HOLD/ENTRY 


QMG 


HOLD/JOB 


QMG 


INITIALIZE 


INItvolume 


INITIALIZE/PROCESSOR 


QMG 


INITIALIZE/QUEUE 


QMG 


INITIALIZE/UPDATE 


Home 


INSTALL 


INStall 


LIBRARY 


LBR 


LINK 


TKB 



LOGIN 
LOGOUT 
MACRO 
MCR 



HELlO 

BYE 

MAC 

MCR 



Create Volume 

Set up despooler task 



Alter volume's 
home block 



Task Builder. May be 
more than one on 
system. STK is Slow TKB. 
FTB is Fast TKB. 
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FUNCTIONS INITIATED BY DCL COMMANDS 



DCL Command 



MCR Command, 
Task, or Utility 



Comments 



MOUNT 


MOUnt 




PRINT 


QMG 




PURGE 


PIP 




RELEASE/ENTRY 


QMG 




RELEASE/JOB 


QMG 




REMOVE 


REMove 




RENAME 


PIP 




REQUEST 


BROadcast 




RUN 


RUN INS 




SET [DAY] TIME 


TIMe 




SET DEFAULT 


SET /UIC 


SET for UFD 
ASN for SY: 


SET DEVICE 


DEVice 




SET GROUPFLAGS 


FLAg 




SET LIBRARY/DIRECTORY 


SET /LIBUIC 




SET PARTITION 


PAR, SET /MAIN, 
SET /PAR, SET SUB 




SET PRIORITY 


ALTer 




SET PROTECTION 


PIP 




SET QUEUE 


QMG 




SET SYSTEM/DIRECTORY 


SET /SYSUIC 




SET SYSTEM/EXTENSION_LIMIT 


SET /MAXEXT 




SET SYSTEM/NOLOGINS 


SET /NOLOGON 




SET SYSTEM/PACKETS 


SET /MAXPKT 




SET SYSTEM/POOL 


SET /POOL 




SET TERMINAL 


SET /attribute 




SHOW ACCOUNT t NIG 


ACC 


Resource ?»o; 


SHOW ASSIGNMENTS 


ASsigN 




SHOW CLOCK_QUEUE 


CLQ 




SHOW COMMON 


CBD 


Common Bloc 


SHOW [DAY] TIME 


TIM 




SHOW DEFAULT 


SET /UIC 


SET for UFD 




ASsigN 


ASN for SY: 
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FUNCTIONS INITIATED BY DCL COMMANDS 



DCL Command 



MCR Command, 
Task, or Utility 



Comments 



SHOW DEVICES 


DEV 

SET /PUB 

SET /BUF 


SHOW GROUPFLAGS 


FLAg 


SHOW LIH.'JARY /DIRECTORY 


SET /LIBUIC 


SHOW MEMORY 


RMD 


SHOW PARTITIONS 


PAR 


SHOW PROCESSOR 


QMG 


SHOW QUEUE 


QMG 


SHOW SYSTEM/CLI 


CLI /SHOW 


SHOW SYSTEM/DIRECTORY 


SET /SYSUIC 


SHOW SYSTEM/EXTENSION_LIMIT 


SET /MAXEXT 


jnun aisiiin/ruuL 


SET /FOOL 


SHOW SYSTEM/SECONDARY_POOL 


SET /SECPOL 


SHOW TASKS/ACTIVE 


ACT 


SHOW TASK:taskname/ACTIVE 


ATL 


SHOW TASKS/DYNAMIC 


RMD 


SHOW TASKS/INSTALLED 


TAS 


SHOW TASKS/INSTALLED/FULL 


TAL 


SHOW TASK:taskname/INSTALLED 


TAS 


SHOW TERMINAL 


DEV 


SHOW TERMINAL/attribute 


SET /attribute 


SHOW USERS 


DEV 


SORT 


SRT 


START 


UNS 


START/PROCESSOR 


QMG 


START/QUEUE 


QMG 


START/QUEUE/MANAGER 


QMG 


START/UNBLOCK 


UNBLOCK 


STOP/ABORT 


QMG 


STOP/BLOCK 


Block 



/PUBLIC qualifier 
/WIDTH qualifier 



Resource Monitoring 
Display 



SORT-11 
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FUNCTIONS INITIATED BY DCL COMMANDS 





MCR Command, 


DCL Command 


Task, or Utility 


STOP/PROCESSOR 


QMG 


STOP/QUEUE 


QMG 


STOP/QUEUE/MANAGER 


QMG 


SUBMIT 


■JMG 


TYPE 


PIP 


UNFIX 


UNFix 


UNLOCK 


PIP 



Comments 
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APPENDIX C 
SUMMARY OF TECHNICAL CHANGES 



This appendix lists all changes in DCL syntax from RSX-llM-PLUS VI. 
to RSX-llM-PLUS V2.0, and from RSX-11M/M-PLUS V4. 0/2.0 to 
RSX-11M/M-PLUS V4. 1/2.1. Section C.l lists all commands and 
qualifiers that have changed syntax since VI. 0, Section C.2 lists all 
syntax elements that have been added to DCL since VI. 0, and Section 
C.3 lists all commands and syntax elements that have been added or 
changed for V4. 1/2.1. 



C.l CHANGED SYNTAX 

This section lists all commands and qualifiers changed since 
RSX-llM-PLUS. 



VI. of 



Old 



New 



ABORT 



APPEND 



/[NO] DUMP 



/INDEXED [/KEY: NUMBER :n] 

/RELATIVE 

/SEQUENTIAL 



ARCHIVE 



/BACKUP_SET:name 

/BAD:arg 

/BUFFERS :n 

/CREATED :arg 

/CREATED : AFTER : t ime 

/CREATED : BEFORE : t ime 

/DIRECTORY 

/DISPLAY 

/ERRORS :n 

/EXTEND :n 

/INVOLUME:volumelabel 

/MAX I MUM :n 

/OUTVOLUME: volumelabel 

/POSITION :arg 

/POSITION:BLOCK:n 

/PROTECTION :code 

/REVISEDtarg 

/REVISED: AFTER: time 

/REVISED: BEFORE: time 

/[NO] SUPERSEDE 

/TAPE LABEL:volumelabel 



ABORT 



APPEND 



BACKUP 



/[NO] POSTMORTEM 



No support (use CONVERT) 
No support (use CONVERT) 
No support (use CONVERT) 



/SAVE_SET : name 

/BADBLOCKS:arg 

/ACCESSED :n 

/CREATED 

/CREATED/AFTER: time 

/CREATED/BEFORE: time 

/LIST 

/LOG 

/ERROR_LIMIT:n 

/EXTENSION :n 

/LABEL: INPUT:volumelabel 

/MAXIMUM_FILES:n 

/LABEL: [OUTPUT: ] volumelabel 

/INDEX:arg 

/INDEX:n 

/FILE_PROTECTION:code 

/MODIFIED 

/MODIFIED/AFTER: time 

/MODIFIED/BEFORE: time 

/[NO] REPLACE 

/LABEL: TAPE: volumelabel 
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SUMMARY OF TECHNICAL CHANGES 



Old 



Hew 



COBOL 



/SWITCHES: 
/SWITCHES: 
/SWITCHES: 
/SWITCHES: 
/SWITCHES: 
/SWITCHES: 
/SWITCHES: 
/SWITCHES: 
/SWITCHES: 
/SWITCHES: 
/SWITCHES: 



COBOL 



arg 

(t-]CVF) 

([-]BOU) 

(t-]CM6) 

([-]CREF) 

(SYM:n) 

(KER:xx) 

(PFM:n) 

(t-]OV) 

([-]PLT) 

(I-]RO) 



/SWITCHES: ([-]NL) 
/SWITCHES: ([-]MAP) 
/SWITCHES: ([-]OBJ) 
/SWITCHES: (ERR:1) 
/SWITCHES: (ERR: 2) 



No support 

/[NO] ANSI FORMAT 

/[NO] CHECK 

/[NO]CM6 

/ [NO] CROSS_REFERENCE 

/LARGE_SYMBOL TABLE :n 

/NAMES: xx 

/NEST:n 

/[NO] OVERLAY 
/ [NO] POOL_LITERALS 
/[NO] READONLY 
/[NOJSHOW: (arg[s] ) 

COPY_LIST 

MAP 

VERB_LOCATION 
/WARNINGS 
/NOWARNINGS 



COPY 



CREATE 



/INDEXED [/KEY: NUMBER :n] 

/RELATIVE 

/SEQUENTIAL 



/FORMAT: arg 

/INDEXED 

/KEY:arg 

/RELATIVE 

/SEQUENTIAL 



COPY 



:reate 



CREATE/DIRECTORY 



DELETE 

/DIRECTORY_ENTRY 
/LIST . 
/SELECTIVE 

DELETE/QUEUE queuename jobname 
DELETE/QUEUE queuename jobname 

DIFFERENCE 

''BLANK LINES 

/NOCOMMENTS 
/FORM_FEED 

/IGNORE_SPACING 
/NOTRAILING_BLANKS 
/VERTICAL_BAR:n 
/CHANGE_BAR 

DIRECTORY 

/PRINT 



No support (use CONVERT) 
No support (use CONVERT) 
No support (use CONVERT) 



No support (use CONVERT) 

No support (use CONVERT) 

No support (use CONVERT) 

No support (use CONVERT) 

No support (use CONVERT) 

CREATE/DIRECTORY 

/LABEL: label 

DELETE 

No support (use PIP) 

/LOG 

/QUERY 

DELETE/ JOB queuename jobname 
DELETE/ENTRY:n 

DIFFERENCES 

Default; to Override, specify 

/IGNORE :BLANK_LINES 
/IGNORE: COMMENTS 
Default; to override, specify 

/IGNORE : FORM_FEEDS 
/IGNORE: SPACING 
/IGNORE: TRAIL ING_BLANKS 
/CHANGE_BAR:n 
/CHANGE_BAR:n 

DIRECTORY 

/PRINTER 



DISMOUNT 



/DEVICE 
/USER 



DISMOUNT 



/PUBLIC 
/ALL 
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SUMMARY OF TECHNICAL CHANGES 



Old 



New 



FIX 



FIX 



/READONLY 




FORTRAN 




/SWITCHES: 


(/CK) 


/SWITCHES: 


(/CO:n) 


/SWITCHES: 


(/DE) 


/SWITCHES: 


(/EX) 


/SWITCHES: 


(/ID) 


/SWITCHES: 


</I4) 


/SWITCHES: 


(/LA) 


/SWITCHES: 


(/Ll:n) 


/SWITCHES 


(/NOTR) 


/SWITCHES: 


(/OP) 


/SWITCHES: 


(/RO) 


/SWITCHES: 


(/SN) 


/SWITCHES: 


(/TR:ALL) 


/SWITCHES: 


(/TR: BLOCKS) 


/SWITCHES 


(/TR:LINES) 


/SWITCHES: 


(/TR: NAMES) 


/SWITCHES 


(/TR:NONE) 


/SWITCHES: 


(/VA) 


/SWITCHES: 


(/WR) 



/READONLY SEGMENT 



FORTRAN 



/[NO]CHECK 

/CONTINUATIONS:n 

/[NO]DLINES 

/[NO] EXTEND 

/IDENTIFICATION 

/[NO] 14 

No support 

/MACHINE_CODE 

/MAP 

/SOURCE 

/TRACEBACK:NONE 

No support 

/SHAREABLE 

/[NO]LINE_NUMBERS 

/TRACEBACKtALL 

/TRACEBACK : BLOCKS 

/TRACEBACK:LINES 

/TRACEBACK : NAMES 

/TRACEBACK: NONE 

/[NO] VECTORS 

/'[NO] WARNINGS 



HELP 



/UNS 



HELP 



No support 



HOLD/QUEUE 

/ENTRY: (m,n) 
HOLD/QUEUE qname jobname 

INITIALIZE (Initalize volume) 
/DENSITY:HIGH 
/DENSITY: LOW 
/INDEX:BLOCK:n 
/MAXIMUM :n 
/PROTECT ION: code 
/VERIFIED 
/NOVERIFIED 
/WINDOW :n 



HOLD 



/ENTRY:n 
/JOB qname [ : ] 



jobname 



INITIALIZE 

No support 
No support 
/INDEX:n 

/MAXIMUM_FILES:n 
/FILE_PROTECTION:code 
/BADBLOCKS: AUTOMATIC 
/BADBLOCKS : MANUAL 
/WINDOWS :n 



INITIALIZE (Initialize QMG function) 
/APPLICATIONS_PROCESSOR 
/BATCH_PROCESSOR 
/DEVICE 
/PRINTER 
/PROCESSOR 



INITIALIZE 

/PROCESSOR :APPLICATIONS_PROCESSOR 
/PROCESSOR : BATCH_PROCESSOR 
/PROCESSOR : DEVICE 
/PROCESSOR: PRINTER 
No support 



INSTALL 



INSTALL 



/[NO] DUMP 
/TASK: name 



/[NO] POSTMORTEM 
/TASK NAME: name 



LIBRARIAN CREATE 
/EPT:n 
/MNT:n 
/SIZE:n 

/[NO]ENTRYPOINTS 
/TYPE: MACRO 
/TYPE: OBJECT 
/SELECT SYMBOLS 



LIBRARY/CREATE 
LIBRARY/CREATE: (GLOBALSm) 
LIBRARY/CREATE: (MODULES :n) 
LIBRARY/CREATE: (BLOCKS :n) 

/[NO]GLOBALS 

/MACRO 

/OBJECT 

/SELECTIVE SEARCH 
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SUMMARY OF TECHNICAL CHANGES 



Old 



New 



LIBRARIAN DELETE/MODULES 
LIBRARIAN DELETE/GLOBAL_SYMBOLS 

LIBRARIAN EXTRACT 

/OUTPUT : f i lespec 

LIBRARIAN INSERT 

/[NO]ENTRYPOINTS 
/SELECT_SYMBOLS 

LIBRARIAN LIST 

/OUTPUT: filespec 
/ENTRIES 

LIBRARIAN REPLACE 

/[NO]ENTRYPOINTS 
/SELECT SYMBOLS 



LIBRARIAN SQUEEZE 






/EPT:n 






/MNT:n 






/SIZE:n 






LINK 






/COMPATIBILITY 


MODE 


/[NO] CONCATENATED 


/DUMP 






/EXTENDED 


ARITHMETIC 


/FLOATING" 


"POINT 


/GLOBAL SYMBOLS 


/LIBRARY modi.. 


•modN 


/MULTIUSER 




/OVERLAY : f i lespec 


/POSITION^ 


INDEPENDENT 


/SELECT SYMBOLS 


/STOPm 






/symbols ? f i lespec 


/WIDE_MAP 






MACRO 

/SWITCHES' 


arg 




/SWITCHES 


(/DS 


arg) 


/SWITCHES 


(/DS 


AMA) 


/SWITCHES 


:(/DS 


ABS) 


/SWITCHES 


(/DS 


CDR) 


/SWITCHES 


:(/DS 


GBL) 


/SWITCHES 


(/DS 


LSB) 


/SWITCHES 


: f /ns 


t»C) 


/SWITCHES 


(/DS 


REG) 


/SWITCHES 


:(/DS 


FPT) 


/SWITCHES 


(/EN 


arg) 


/SWITCHES 


. (/EN 


AMA) 


/SWITCHES 


(/EN 


ABS) 


/SWITCHES 


(/EN 


CDR) 


/SWITCHES 


(/EN 


GBL) 


/SWITCHES 


(/EN 


LSB) 


/SWITCHES 


(/EN 


LC) 


/SWITCHES 


(/EN 


REG) 


/SWITCHES 


(/EN 


FPT) 



LIBRARY/DELETE libspec module [s] 
LIBRARY/REMOVE libspec global [s] 

LIBRARY/EXTRACT libspec module [s] 
/OUTPUT [rfilespec] 

LIBRARY/INSERT 

/[NO]GLOBALS 
/SELECTIVE_SEARCH 

LIBRARY/LIST [ :f ilespec] 

No support (use /LIST:f ilespec) 
/NAMES 

LIBRARY/REPLACE 

/[NO]GLOBALS 
/SELECTIVE_SEARCH 

LIBRARY/COMPRESS 
LIBRARY/COMPRESS: (GLOBALS:n) 
LIBRARY/COMPRESS: ( MODULES :n) 
LIBRARY /COMPRESS: (BLOCKSm) 



LINK 



MACRO 



/COMPATIBLE 

/[NO] CONCATENATE 

/POSTMORTEM 

/CODE:EAE 

/CODE :F IS 

,/GLOBALS 

/INCLUDE: (modi, . . . ,modN) 

/SHAREABLE 

/OVERLAY_DESCR I PT I ON 

/CODE : POS I T I ON_I NDEPENDENT 

or /CODE: PIC 
/SELECTIVE_SEARCH 
/ERROR LIMIT:n 



/WIDE 



No support 
/DISABLE: (arg[s]) 

ABSOLUTE 

BINARY 

CARD_FORMAT 

GLOBAL 

LOCAL 

LOWER CASE 

REGISTER_DEFINITIONS 

TRUNCATION 
/ENABLE: (arg[s] ) 

ABSOLUTE 

BINARY 

CARD_FORMAT 

GLOBAL 

LOCAL 

LOWER_CASE 

REGISTER_DEFINITIONS 

TRUNCATION 
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Old 



New 



/SWITCHES: 


(/LI: 


arg) 


/SWITCHES: 


(/LI: 


BEX) 


/SWITCHES: 


(/Li: 


BIN) 


/SWITCHES 


(/LI 


CND) 


/SWITCHES: 


(/LI 


COM) 


/SWITCHES 


(/LI 


LD) 


/SWITCHES: 


(/LI 


LOC) 


/SWITCHES 


(/LI 


MC) 


/SWITCHES: 


(/LI 


MD) 


/SWITCHES 


(/LI 


ME) 


/SWITCHES 


(/LI 


MEB) 


/SWITCHES 


(/LI 


SEQ) 


/SWITCHES 


(/LI 


SRC) 


/SWITCHES 


</LI 


SYM) 


/SWITCHES 


(/LI 


TOC) 


/SWITCHES 


</NL 


:arg) 


/SWITCHES 


(/NL 


•BEX) 


/SWITCHES 


(/ML 


:BIN) 


/SWITCHES 


(/NL 


.CND) 


/SWITCHES 


:(/NL 


:COM) 


/SWITCHES 


(/NL 


LD) 


/SWITCHES 


: (/NL 


:LOC) 


/SWITCHES 


(/NL 


:MC) 


/SWITCHES 


(/NL 


:MD) 


/SWITCHES 


(/NL 


:ME) 


/SWITCHES 


:(/NL 


:MEB) 


/SWITCHES 


:(/NL 


:SEQ) 


/SWITCHES 


:(/NL 


:SRC) 


/SWITCHES 


(/NL 


:SYM) 


/SWITCHES 


:(/NL 


:TOC) 


/SWITCHES 


:(/NL 


:TTM) 


/SWITCHES 


:(/LI 


:TTM) 


MESSAGE/TERMINAL :c 


3ev: 




MESSAGE Qfilespec 






/LOGGED 01 


* 





/SHOW: (arg[s] ) 

EXTENSIONS 

OBJECT BINARY 

CONDITIONALS 

COMMENTS 

LISTING_DIRECTIVES 

COUNTER 

CALLS 

DEFINITIONS 

EXPANSIONS 

BINARY 

SEQUENCE_NtIMBERS 

SOURCE 

SYMBOLS 

CONTENTS 
/NOSHOW: (arg[s] ) 

EXTENSIONS 

OBJECT BINARY 

CONDITIONALS 

COMMENTS 

LISTING_DIRECTIVES 

COUNTER 

CALLS 

DEFINITIONS 

EXPANSIONS 

BINARY 

SEQUENCE_NUMBERS 

SOURCE 

SYMBOLS 

CONTENTS 
/WIDE 
/NOWIDE 



BROADCAST dev: 
BROADCAST @filespec 
/LOGGED IN 



MOUNT 



/ACP:name 

/F I LE_CONTROL_BLOCKS : n 

/PROTECTION: code 

/UNLOCKED_INDEX 

/WINDOW:n 



MOUNT 



/PROCESSOR i name 

/ACCESSED :n 

/FI LE_PROTECT ION : code 

/UNLOCK 

/WINDOWS :n 



PRINT 



/JOB: jobname 
/ORIGINAL 
/NOORIGINAL 
/PAGES :n 



PRINT 



/NAME: jobname 
/NOTRANSFER 
/TRANSFER 
/PAGE COUNT :n 



PURGE 



/LIST 



PURGE 



/LOG 



RELEASE/QUEUE 

/ENTRY: (m,n) 
RELEASE/QUEUE qname jobname 



RELEASE 



/ENTRY:n 

/JOB qname jobname 



RUN 



/DRIVER 
/[NO] DUMP 
/TASK: name 



RUN 



No support (use MCR LOAD) 

/[NO] POSTMORTEM 
/TASK NAME .-name 



SET DEFAULTS [dev:][uic] 



SET DEFAULT: [dev:] [uic] 
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Old 



New 



SET DEVICE :dev: option [s] 

[NO]CHECKPOINT_FILE[:n] 
[NO] LOWER 
[NO] PUBLIC 
WIDTH:n 
[NO]WRITECHECK 

SET GROUPFLAGS CREATE [n] 
SET GROUPFLAGS DELETE [n] 

SET LIBRARY_UFD:ufd 

SET [NO] LOGINS 

SET PARTITIONS options 

NAME: name 

BASE:n 

SIZE:n 

TYPE: DEVICE 

TYPEIDIAGNOSTIC 

TYPE: SYSTEM 
SET NOPARTITION name 



SET DEVICE:dev:/qualif ier [s] 

/[NO]CHECKPOINT_FILE[:n] 
/[NO] LOWERCASE 
/[NO] PUBLIC 
/WIDTH :n 
/[NO]WRITECHECK 

SET GROUPFLAGS :n/CREATE 
SET GROUPFLAGS :n/DELETE 

SET LIBRARY/DIRECTORY :ufd 

SET SYSTEM/ [NO] LOGINS 

SET PARTITION:name/qualifiers 

"name" is argument to PARTITION 

/BASE:n 

/SIZE:n 

/DEVICE 

/DIAGNOSTIC 

/SYSTEM 
SET NOPARTITION:name 



SET PRIORITY name number 

SET PROTECTION filespec[s] code 

SET QUEUE ENTRY: (m,n) option[s] 
SET QUEUE queuename jobname 
AFTER: time 
FORMS :n 
HOLD 
LENGTH:n 

[NO] LOWERCASE 
PAGES :n 
PRIORITY:n 
RELEASE 

l«Gj RESTART 

[NO] UPPERCASE 

SET SYSTEM_UFD ufd 

SET TERMINAL [:TTnn:] option 
ASR33 
ASR35 
DCL 

[NO] ECHO 
[NO]EIGHT_BIT 
[NO] ESCAPE 
[NO]FORM_FEED 
[NO]FULL_DUPLEX 
[NO]HARDCOPY 
HFILL:n 

[NO]HOLD_SCREEN 
[NO] INTERACTIVE 
KSR33 
LA30P 
LA30S 
LA36 
LA120 
LA180S 
[NO] LOCAL 
[NO] LOWERCASE 



SET PRIORITY:n name 

SET PROTECTION filespec[s] (code) 

SET QUEUE/ENTRY:n/qualifier[s] 
SET QUEUE/JOB queuename jobname 

/AFTER: time 

/FORMS : n 

/HOLD 

/LENGTH :n 

/[NO] LOWERCASE 

/PAGE_COUNT : n 

/PRIORITY:n 

/RELEASE 

/ [NO] RESTART 

/[NO] UPPERCASE 

SET SYSTEM/DIRECTORY :ufd 

SET TERMINAL [:TTnn:] /qualifier [s] 
/ASR33 
/ASR35 
/DCL 

/[NO] ECHO 
/[NO]EIGHT_BIT 
/[NO] ESCAPE 
/[NO]FORM_FEED 
/[NO]FULL_DUPLEX 
/[NO]HARDCOPY 
/CRFILL:n (synonym) 
/[NO]HOLD_SCREEN 
/[NO] INTERACTIVE 
/KSR33 
/LA30P 
/LA30S 
/LA 36 
/LA120 
/LA180S 
/[NO] LOCAL 
/[NO] LOWERCASE 
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SUMMARY OF TECHNICAL CHANGES 



Old 



New 



MCR 
PAGE:n 

[NO]PASSALL 

[NO] REMOTE 

[NO] SCOPE 
SPEED:arg 

[NO] TAB 

[NO]TYPE_AHEAD 
UNKNOWN :n 

[NO] UPPERCASE 
VFILL:n 
VT05 
VT52 
VT55 
VT61 
VT100 

[NO] WRAP 

SHOW ACCOUNTING INFORMATION 

SHOW ASSIGNMENTStarg 
SGLOBAL 

: LOCAL 
:LOGIN 
:TERMlNAL:dev: 

SHOW BUFFER_POOL 

SHOW COMMON_BLOCK_DIRECTORY name opt 

TASKS 



/MCR 

/PAGE_LENGTH:n 

/[NO]PASSALL 

/[NO] REMOTE 

/[NO] SCOPE 

/SPEED: (arg) 

/[NO] TAB 

/ [NO] TYPE_AHEAD [ : n] 

/MODEL :n 

/[NO] UPPERCASE 

/LFFILL:n (synonym) 

/VT05 

/VT52 

/VT55 

/VT61 

/VT100 

/[NO] WRAP 

SHOW ACCOUNTING/INFORMATION 

SHOW ASSIGNMENTS/qualifier 
/GLOBAL 

/SYSTEM (synonym added) 
/LOCAL 
/LOGIN 
/TERMINAL :dev: 

SHOW SYSTEM/POOL 

SHOW COMMON [: name] /qualifier 
/TASK 



SHOW DEFAULTS 

SHOW DEVICES option 
[NO] PUBLIC 
TYPE dd: 
WIDTH :ddnn: 
[NOJWRITECHECK 

SHOW LIBRARY_UFD 

SHOW LOGICAL_UNITS 

SHOW PARTITIONS name 

SHOW PROCESSOR ALL 
SHOW PROCESSOR name 

SHOW QUEUE ALL option [s] 

SHOW QUEUE queuename option [s] 

SHOW QUEUE ENTRY; (m,n) option[s] 

ALL 

BATCH 

BRIEF 

FULL 

FORMS 

NAME: name 

NUMBER 

PRINT 

PRIORITY:n 

USER: [g,m] 



SHOW DEFAULT 

SHOW DEVICES [:dd[:] ]/qualifier 
/[NO] PUBLIC 

"dd:" is argument to DEVICES 
/WIDTH 
No support 

SHOW LIBRARY/DIRECTORY 

SHOW TASKS [: name] /LOG ICAL_UN ITS 

SHOW PARTITIONS :name 

SHOW PROCESSOR 

SHOW PROCESSOR name [ : ] 

SHOW QUEUE/qualifier [s] 

SHOW QUEUE queuename/qualifier [s] 

SHOW QUEUE/ENTRY :n/qualifier [si 

/ALL 

/BATCH 

/BRIEF 

/FULL 

/FORMS 

/NAME: name 

/NUMBER 

/PRINTER 

/PRIORITY :n 

/OWNER UIC: [g,m] 
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Old 



New 



SHOW SYSTEM_UFD 

SHOW TASKS option 

ACTIVE [TERMINAL:TTnn:] 

ALL 

BRIEF 

FULL 

INSTALLED 

SHOW TERMINAL [:TTnn:] option 
[NO]ASR33 
[NO]ASR35 
DCL 

[NO] ECHO 
[NO]EIGHT_BIT 
[NO] ESCAPE 
[NO]FORM_FEED 
[NO]FULL_DUPLEX 
[NO]HARDCOPY 
HFILL 

[NO]HOLD_SCREEN 
[NO] INTERACTIVE 
[NO]KSR33 
[NO]LA30P 
[NO]LA30S 
[NO]LA36 
[NO]LA120 
[NO]LA180S 
[NO] LOCAL 
[NO] LOWERCASE 
MCR 
MODEL 
PAGE 

[NO] PASSALL 
[NO] PRIVILEGE 
[NO] REMOTE 
[NO] SCOPE 
[NO] SLAVE 
SPEED 
[NO] TAB 

[NO]TYPE_AHEAD 
[NO] UPPERCASE 
VFILL 
[NO]VT05 
[NO]VT52 
[NOJVT55 
[NO]VT61 
[NO]VT100 
[NOJWRAP 

SORT/O0TPUT:file inputfile 
/FILES:n 

/FORMAT: { format :size) 
/KEYS:arg 

START/processortype 

/APPLICATIONS_PROCESSOR 

/BATCH_PROCESSOR 

/DEVICE 

/PRINTER 

/PROCESSOR 

/AT_PAGE:n 

/NEXT JOB 



SHOW SYSTEM/DIRECTORY 

SHOW TASKS [: name] 

/ACTIVE[:TTnn[:]] 

/ALL 

/BRIEF 

/FULL 

/INSTALLED 

SHOW TERMINAL [:TTnn:] [/qualifier] 
/ASR33 
/ASR35 
/DCL 

/[NO] ECHO 
/[NO]EIGHT_BIT 
/[NO] ESCAPE 
/[NO]FORM_FEED 
/[NO]FULL_DUPLEX 
/[NOJHARDCOPY 
/CRFlLLm (synonym) 
/[NO]HOLD_SCREEN 
/[NO] INTERACTIVE 
/KSR33 
/LA30P 
/LA30S 
/LA36 
/LA120 
/LA180S 
/[NO] LOCAL 
/[NO] LOWERCASE 
/MCR 
/MODEL 

/PAGE_LENGTH 
/[NO] PASSALL 
/[NO] PRIVILEGE 
/[NO] REMOTE 
/[NO] SCOPE 
/[NO] SLAVE 
/SPEED 
/[NO] TAB 
/[NO]TYPE_AHEAD 
/[NO] UPPERCASE 
/LFFILL (synonym) 
/VT05 
/VT52 
/VT55 
/VT61 
/VT100 
/[NO] WRAP 

SORT inputfile outputfile 
/WORK_FILES:n 
/FORMAT: (format, size) 
/KEY:arg 

START/PROCESSOR : type 
APPL ICAT I ONS_PROCESSOR 

BATCH_PROCESSOR 

DEVICE 

PRINTER 

No support 

/PAGE : n 

/NEXT 
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Old 



New 



STOP 
STOP/DRIVER 

STOP/processortype 

/APPLICATIONS_PROCESSOR 

/BATCH_PROCESSOR 

/DEVICE 

/PRINTER 

/PROCESSOR 



SUBMIT 



UNFIX 



/PRINT 

/NOORIGINAL 

/ORIGINAL 



/READONLY 



No support 

No support (use MCR UNLOAD) 

STOP/PROCESSOR : type 

APPLICATIONS_PROCESSOR 

BATCH PROCESSOR 

DEVICE 

PRINTER 

NO support 



SUBMIT 



UNFIX 



/PRINTER 

/TRANSFER 

/NOTRANSFER 



/READONLY SEGMENT 



C.2 NEW SYNTAX 

This section lists all syntax added to RSX-11M-PLUS DCL since VI. 0. 
Many qualifiers have also added the /NO form, but these are not 
listed. Most /NO forms are defaults. 



ALLOCATE/TYPE :devtype 



APPEND 



ASSIGN 



/DATE:dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH :dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH :dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 



/SYSTEM (synonym for /GLOBAL added), 



BACKUP 

/DENSITY:6250 

/NOLOG 

/PRESERVE 

BROADCAST username 
/ALL 
/LOGGED IN 
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CONVERT (new command) 
/[NO]APPPEND 
/BLOCK_SIZE:n 
/[NO]FIXED_CONTROL 
/ [NO] IDENTIFICATION 
/INDEXED 
/KEY[:n] 

/[NO]LOG_FILE [:f ilespec] 
/[NO]MASS_INSERT 
/MERGE 

/[NO]PAD[: [#]x] 
/RELATIVE 
/[NO] REPLACE 
/SEQUENTIAL 
/[NO] TRUNCATE 



COPY 



/DATE:dd-mmm-yy 

/SINCE: dd-mmm-yy 

/THROUGH :dd-mmm-yy 

/S I NCE : dd-mmm-yy/THROUGH : dd-mmm-yy 

/TODAY 

/EXCLUDE : f i lespec 



DEASSIGN 

/SYSTEM (synonym for /GLOBAL added) 

DEBUG (new command) 

DELETE 

/DATE: dd-mmm-yy 

/S I NCE : dd-mmm-yy 

/THROUGH : dd -mmm-yy 

/S I NCE : dd-mmm-yy/THROUGH : dd-mmm-yy 

/TODAY 

/EXCLUDE: f ilespec 

DELETE/JOB 

/FILE_POSITION:n 
DELETE/ENTRY :n 

/FTT.R PDRTTTOMtn 



DIRECTORY 

/DATE : dd-mmm-yy 

/S I NCE : dd-mmm-yy 

/THROUGH: dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE : f i lespec 



EDIT/EDT 



/ [NO ]COMMAND[:f ilespec] 
/ [NO] JOURNAL [ : f ilespec] 
/[NO]OUTPUT[:f ilespec] 
/[NO]READ_ONLY 
/[NO] RECOVER 



EDIT/KED 
EDIT/K52 



/CREATE 

/OUTPUT [ : f i 1 espec 1 
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EDIT/SLP 

/[NO]AUDIT_TRAIL[: (arg[s] ) ] 

POSITIONS 

SIZE:n 
/[NO] CHECKSUM [:n] 
/[NO]LIST[:filespec] 
/ [NO] OUTPUT [ : f ilespec] 
/[NO] REPORT 
/[NO] TAB 
/[NO] TRUNCATE [:n] 

FORTRAN/FOR 

/CODErarg 

EAE 
EIS 
FIS 
THREADED 

FORTRAN/F77 
FORTRAN/NOF77 

HELP 

/CLI :cliname 

/FILE: f ilespec 

/GROUP 

/LOCAL 

/OUTPUT : f i lespec 

INITIALIZE (Initialize volume) 
/BADBLOCKS: OVERRIDE 
/DENSITY:6250 

INITIALIZE (Initialize QMG function) 
/PROCESSOR : CARD_READER 
/PROCESSOR: INPUT 
/BATCH_QUEUE : name 
/CONSOLE :dev: 
/PRINTER_QUEUE:name 
/SHAREABLE 
/NOSHAREABLE 
/NOUPPERCASE 
/NOLOWERCASE 

INITIALIZE/UPDATE (new command) 
/ACCESSED :n 
/DENSITYsarg 

800 

1600 

6250 
/EXTENSIONS 
/FI LE_PROTECTION : code 
/OWNER: [g,m] 
/MAXIMUM_FILES:n 
/PROTECTION: code 
/SHOW 
/LABEL 
/WINDOWS :n 



C-ll 



SUMMARY OF TECHNICAL CHANGES 



INSTALL 



/COMMAND :"taskcommand" 



LIBRARY/CREATE 

/UNIVERSAL 



LINK 



LOGOUT 



MOUNT 



PRINT 



PURGE 



/EXECUTABLE: filespec (synonym for /TASK added) 
/SAVE 



/[NO] HOLD 



/BLOCK_SIZE:n 
/CARRIAGE_CONTROL:arg 

FORTRAN 

LIST 

NONE 
/DEFAULT :arg 

[NO] UNLOAD 

SAVE 
/DENSITY:6250 
/[NO]HDR3 
/[NO] LABEL 
^OVERRIDE : Sirci 

ACCESSIBILITY 

SET_IDENTIFICATION 
/OWNER_UIC: [uic] 
/[NO] PUBLIC 
/RECORD_SIZE:n 
/[NO]SHAREABLE 

/ riml *-* *f r* m tt» »* 

/ tnujoioiDi'i 

/TRANSLATE :arg 

EBCDIC 

NONE 

UT1 

UT2 

UT3 
/VOLUME_IDENTIFICATION:name[s] 
/[NO]WAIT 



/WINDOWS :n 
/[NOJWRITE 



/JOB_COUNT:n 
/[NO] JOB_PAGE 
/NOLOWERCASE 
/NOUPPERCASE 



/NOLOG 

/DATE:dd-mmm-yy 

/S I NCE : dd-mmm-yy 

/THROUGH :dd-mmm-yy 

/S I NCE : dd-mmm-yy/THROUGH : dd-mmm-yy 

/TODAY 

/EXCLUDE : f i lespec 
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REQUEST (new command) 

RUN 

/COMMAND : " taskcommand " 

SET PARTITION: name 

/COMMON (RSX-11M only) 

/SUBPARTITION (RSX-11M only) 

/TASK (RSX-11M only) 

SET PROTECTION 

/DATE:dd-mmm-yy 

/S I NCE : d d-mmm-yy 

/THROUGH :dd-mmm-yy 

/S I NCE : dd-mmm-yy/THROUGH : dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 

SET QUEUE/ENTRY:n 

SET QUEUE/JOB queuename jobname 

/COPIES :n 

/[NO] DELETE 

/FILE_POSITION:n 

SET SYSTEM 

/PACKETS :n 

/POOL : top :max : total 

SET TERMINAL [:TTnn:] 
/WIDTH :n 
/[NO] BROADCAST 

SHOW ACCOUNTING 

/TRANSACTIONS [:infile] outfile 

SHOW PROCESSOR 
/BATCH 

/CARD_READER 
/DEVICE 
/INPUT 
/PRINT 

SHOW QUEUE 

/DEVICE 
/FILES 

SHOW SYSTEM 
/CLI 

/EXTENSION_LIMIT 
/SECONDARY_POOL 

SHOW TASKS 

/DYANAMIC 

SHOW TASK:taskname/DYNAMIC 
/RATE:n 
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SHOW TASKS/ACTIVE/DYNAMIC 

/OWNER :ddnn: 

ALL 
/PRIORITYtn 
/RATE:n 

SORT 

/NOCONTIGUOUS 
/SPECIFICATION: filespec 

START/PROCESSOR : type 
CARD_READER 
INPUT 

START/UNBLOCK (new command) 

STOP 

/ABORT printername: 
/PROCESSOR :arg 

CARD_READER 
INPUT 

STOP/BLOCK (new command) 

SUBMIT 



TYPE 



UNLOCK 



/[NO] LOG FILE 



/DATE : dd-mmm-yy 

/S I NCE : dd-mmm-yy 

/THROUGH : dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 



/DATE : dd-mmm-yy 

/SINCE :dd-mmm-yy 

/THROUGH: dd-mmm-yy 

/SINCE :dd-mmm-yy/THROUGH: dd-mmm-yy 

/TODAY 

/EXCLUDE: filespec 



C.3 NEW OR CHANGED COMMANDS AND SYNTAX FOR V4. 1/2.1 

This section lists all syntax added to or changed in RSX-11M/M-PLUS 
DCL since V4. 0/2.0. 

BACKUP /DIRECTORY 
/IMAGE :arg 
SAVE 
RESTORE 



BASIC BASIC-PLUS-2 is now the default compiler. 
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COBOL COBOL-81 is now the default compiler. 

Qualifiers added for COBOL-81: 

/[NO]ANSI_FORMAT 
/[NO]CHECK:arg 

[NO]BOUNDS 

[NO] PERFORM 
ALL 
NONE 
/CODE: [NO]CIS 
/ [NO ] CROSS_REFERENCE 
/[NO] DEBUG 

/ [NO] DIAGNOSTICS [ : f i lespec] 
/ [NO] LIST [:f i lespec] 
/NAMES: xx 

/ [NO] OBJECT [ : fi lespec] 
/ [NO] OVERLAY_DESCRIPTION 
/[NO] SHOW: [NO] MAP 
/[NO] SKELETON 
/[NO] SUBPROGRAM 
/TEMPORARY :device 
/[NO] TRUNCATE 
/[NO]WARNINGS: [NO] INFORMATIONAL 

For the PDP-11 COBOL compiler, the /[NO]ODL 
qualifier has been deleted while the /[NO]SKL, 
/Cll, /[NO] SUBPROGRAM, and /TEMPORARY :dev 
qualifiers have been added. 

CORAL New command and qualifiers to invoke the CORAL 66 compiler, 

Qualifiers are: 

/[NO] CHECK 
/CODE:arg 
EIS 
FIS 
FPP 
PIC 

(EIS, PIC) 
(FIS, PIC) 
(FPP, PIC) 
/ [NO] EXTEND_SOURCE 
/[NO]LIST[:filespec] 
/ [NO] MACHINE_CODE 
/NAMES :x 

/ [NO] OB JECT [ : f i lespec] 
/ [NO] OPTIMIZE [: LEVEL :n] 
/READ_ONLY[:arg] 
ALL 
NONE 

PURE DATA 
/[NO]SHOW[:arg[,i] ) ] 
ALL 

[NO] EXPANSIONS 
NONE 

[NO] OVERRIDE 
[NO] SOURCE 
[NO] STATISTICS 
[NO] SYMBOLS 
/[NO] STANDARD 
/TEST[:n] 
/[NO]TRACEBACK 
/WIDTH :n 
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EDIT 



EDT is now the default editor. 



FORTRAN 



FORTRAN IV-PLUS has been superseded by FORTRAN-77, 
although both compilers are supported by DCL 
(as well as FORTRAN IV) . 

Qualifier added for FORTRAN-77: 

/[NO]STANDARD:arg 
ALL 
NONE 
SOURCE 
SYNTAX 



LINK/C81 



New syntax and qualifiers for command to link 
COBOL-81 object files: 

LINK/C81 [/qualifier [s] ] filespec[,s] 

LINK/COBOL [/qualifier [s] ] filespec[,s] 

/[NOJFMS 

/OTS: [NO] RESIDENT 

/[NO] RMS: [NO] RESIDENT 



SET DEVICE /CHECKPOINT_FILE and /WIDTH now accept 
decimal numbers by default. 

SET PROTECTION Another format allowed: 

SET PROTECTION:code [/qualifier [s] ] filespec[,s] 

SET TERMINAL /HFILL and /VFILL are not synonyms 
SHOW TERMINAL for /CRFILL and /LFFILL, respectively. 
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Abbreviation 

DCL, 1-7 to 1-8, 9-1 
ABORT command, 7-16 to 7-21, 

9-2 
Account File Maintenance 
Program 

See ACNT 
ACNT, 3-4, 4-2, 5-8, 5-72 
ACP, 5-26, 5-28 to 5-42, 6-67 
ACT command 

MCR, 3-2 
Active task, 7-1, 7-55 to 7-57 
Active Task List 

See ATL 
ALLOCATE command, 5-4, 5-9, 

5-22 to 5-24, 9-2 
ALT MODE key, 3-12 
Ancillary Control Processor 

See ACP 
Angle bracket, 3-15 
ANSI file name 

DCL, 1-10 
ANSI magtape, 5-12 
APPEND command, 4-61 to 4-63, 

9-2 
Arrow key 

See Cursor-control key 
Assemble, 6-1 
Assembler 

MACRO-11, 6-2 to 6-11 
ASSIGN command, 4-77 to 4-78, 
5-7 to 5-8, 5-13 to 5-15, 
5-72 to 5-73, 9-3 
ASSIGN/LOGIN command, 5-8 
ASSIGN/QUEUE command, 9-3 
ASSIGN/REDIRECT command, 5-16 

to 5-18, 9-3 
ASSIGN/TASK command, 5-7, 5-18 

to 5-19, 9-4 
Asterisk (*) , 3-16, 4-6 to 4-8 
At sign (@) , 3-16 
AT.. 1-17 

ATL, 7-46 to 7-50, 7-55 to 7-57 
Attached terminal, 3-2 

BACK SPACE key, 3-13 
Backup and Restore Utility 

See BRU utility 
BACKUP command, 5-11, 5-60 to 

5-71, 9-4 to 9-5 
Bad Block Locator Utility 

See BAD utility 
BAD utility, 5-10 to 5-12, 5-64 

to 5-65 
BADBLK.SYS file, 5-11, 5-65 



Base number 

in DCL, 1-8 
BASIC command, 6-2, 6-11 to 

6-13, 9-5 
BASIC-11/IAS-RSX, 6-11 to 6-13, 

9-5 
BASIC-PLUS-2/IAS-RSX, 6-11 to 

6-13, 9-5 
Batch processing, 9-46 
Beep, 3-22 
Bell, 3-22 

BITMAP. SYS file, 5-11, 5-65 
Blocked task, 7-23 to 7-26 
BROADCAST command, 3-29 to 3-31, 

9-6 
BRU utility, 5-12, 5-60 to 5-71 

See also BACKUP command 
Buzz, 3-22 

CANCEL command, 7-22 to 7-23, 

9-6 
CAPS LOCK key, 3-14 
Checkpoint file, 5-11, 5-65, 

5-74, 6-68 
Checkpointing, 5-11, 6-68 
Circumflex {) , 3-15, 3-18 
CL: 

pseudo device, 5-6 
CLI, 1-1 
Clock queue, 7-12 to 7-15, 7-23, 

7-60, 9-37 
CMP utility, 4-69 to 4-75, 9-13 

See also DIFFERENCES command 
CO: 

pseudo device, 5-6 
COBOL command, 6-2, 6-21 to 

6-32, 9-6 to 9-7 
Colon (:) , 3-16 

DCL, 1-9 
Command Line Interpreter 

See CLI 
Comments 

DCL, 1-11 
Commercial-at sign (@) , 3-16 
Common 

resident, 7-61, 9-37 

shareable, 6-73 
Compile, 6-1 
Compiler 

BASIC-PLUS-2, 6-2, 6-12 to 
6-13 

COBOL-81, 6-2, 6-21 to 6-27, 
9-6 

C0B0L/C11, 6-2, 6-27 to 6-32, 
9-7 
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Compiler (Cont.) 

CORAL 66, 6-2, 

9-9 

F4P, 6-2, 6-13 

F77, 6-2, 6-13 

FOR, 6-2, 6-13 

FORTRAN IV, 6-2 

9-16 

FORTRAN IV-PLUS 

6-20, 9-16 

FORTRAN-77, 6-1 

PDP-11 COBOL, 6 

6-32, 9-7 

Continuation line 

See Line contin 

CONTINUE command, 

9-8 

Control key 

See CTRL key 

CONVERT command, 

9-8 

COPY command, 4-3 

COPY key, 3-14 

CORAL 66 command, 

CORAL command, 6- 

CQRIMG.SYS file 
5_74~~ 

CREATE command, 4 

9-10 
CREATE/DI RECTORY 

to 4-13, 9-10 
CTRL key, 3-18 



6-32 to 6-39, 

to 6-20, 9-16 
to 6-20, 9-16 
to 6-20, 9-16 
, 6-13 to 6-20, 

, 6-2, 6-13 to 

3 to 6-20 
-2, 6-27 to 



nation 
7-21 to 7-22, 



4-43 to 4-49, 

7 to 4-41, 9-8 

9-9 
32 to 6-39 

C— 1 1 c_cc 
_/ J, J. / *J \J ^ f 

-10 to 4-11, 
command, 4-11 

3-18 



CTRL/G , 


3- 


-22 








CTRL/I, 


3- 


-22 








CTRL/K, 


3- 


-22 








CTRL/L, 


3- 


-22 








CTRL/M, 


3- 


-22 








CTRL/0, 


3- 


-18, 


3- 


-20 




CTRL/Q, 


3- 


-14, 


3- 


-19 




CTRL/R, 


3- 


-21 








CTRL/S, 


3- 


-14, 


3- 


-19 




CTRL/U, 


3- 


-20 


to 


3-21 




CTRL/X , 


3- 


-21 








CTRL/Z, 


3- 


•12, 


3- 


-18, 3- 


-20 


Cursor-i 


^ontrol 1 


<ey, 3- 


-17 



Date 

system, 2-1, 8-1 to 8-2, 9-31, 
9-37 
Date format 

DCL, 1-8 
DCL, 1-1 to 1-2, B-l 

ANSI file name, 1-10 

colon ( : ) , 1-9 

command line, 1-2 

comments, l-ll 

dates, 1-8 

equal sign (=) , 1-9 

errors, 1-13 

line continuation, 1-11, 3-12 

number 



DCL 

number (Cont.) 
decimal, 1-8 
octal, 1-8 
parameter, 1-8 
qualifier, 1-3 to 1-5 
RSX-11M/M-PLUS, 1-19 
short forms, 1-7 to 1-8, 9-1 
underscore (_) , 1-9 
VAX/VMS, 1-19 
DCL command, 1-7 
DEALLOCATE command, 5-24 to 

5-25, 9-10 
DEASSIGN command, 5-19 to 5-21, 

9-11 
DEASSIGN/QUEUE command, 9-11 
DEBUG command, 6-90 to 6-91, 

9-11 
DEC Standard Editor 

See EDT editor 
DECnet 

DCL, 1-10 
DECscope, 3-1 
DECtape, 5-4 
DECwriter II, 3-1 
Default device, 2—4, 4-2 to 4—3, 
4-77 to 4-79, 5-72 to 5-73, 
9-31 
Default UFD, 4-3, 4-77 to 4-79, 

5-72, 9-31 
DELETE command, 4-31 to 4-34, 

9-12 
DELETE key, j-13 
DELETE/ENTRY command, 9-12 
DELETE/JOB command, 9-12 
DELETE/PROCESSOR command, 9-13 
DELETE/QUEUE command, 9-13 
Device, 5-1, 5-4 

default, 2-4, 4-2 to 4-3, 
4-77 to 4-79, 5-72 to 
5-73, 9-31 
peripheral, 5-1 
physical, 5-1 to 5-3, 5-5, 

5-8 
private, 5-9, 5-13, 5-22 to 

5-25 
pseudo, 5-1 to 5-8 
public, 5-9, 5-13, 5-75 
random access, 5-3 
record-oriented, 5-3 
redirection, 5-16 to 5-18 
shareable, 5-9, 5-13 
shared, 5-13 
unit record, 5-3 
unowned, 5-9, 5-13 
Device attributes, 5-77 to 5-80 
Device independence, 5-8 
Device name, 5-1 
DIFFERENCES command, 4-69 to 

4-75, 9-13 
DIGITAL Command Language 

See DCL 
000000. DIR file, 5-11, 5-65 
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DIRECTORY command, 4-22 to 4-31, 

9-14 
Disk 

preparation, 5-10 to 5-11 

scratch, 5-10 to 5-11 
Disk Save and Compress Utility 

See DSC utility 
Disk Volume Formatter Utility 

See FMT utility 
DISMOUNT command, 5-9, 5-11 to 
5-12, 5-38, 5-42 to 5-46, 
9-14 
DMP utility, 5-12 
Dormant task, 7-1 
DSC utility, 5-12 



to 4-22, 9-16 
4, 4-21 to 

4-14 to 4-16, 

4-17 to 4-19 

22, 9-15 

16 

22, 9-16 

22, 9-16 

19, 9-15 

22, 9-16 

-22, 9-16 

itor, 4-14 to 

3-17 
16 



Echo, 3-11 

EDI editor, 4-20 

EDIT command, 4-1 

4-22 
EDIT/EDT command, 

9-15 
EDIT/SLP command, 
Editor 

EDI, 4-20 to 4- 
EDT, 4-14 to 4- 
K52, 4-20 to 4- 
KED, 4-20 to 4- 
SLP, 4-17 to 4- 
SOS, 4-20 to 4- 
TECO, 4-20 to 4 
EDT editor 

DEC Standard Ed 
4-16, 9-15 
ENTER key, 3-12, 
Equal sign (=) , 3 

DCL, 1-9 
Error 

DCL, 1-13 
Error message, A- 
ESC key, 3-12 
ESCAPE key, 3-12 
ESCAPE sequence f 

3-17 
Event flags 

group global, 6 
9-32, 9-38 
EXELIB.OLB file, 
EXEMAC.MLB file, 
Extension 
file 

See File type 



Fast Task Builder, 6-70 to 6-71 
File, 4-1 

checkpoint, 5-11, 5-65, 5-74, 
6-68 

locked, 4-75 to 4-76, 9-47 

protection, 4-9 
File Compare Utility 

See CMP utility 
i.j.e uunip u 1 1 j. j. i_y 

See DMP utility 



rom terminal, 



-91 to 6-92, 

6-40 
6-41 



File name, 4-3 
File protection, 2-6, 4- 
to 4-82, 5-28, 5-38, 
5-58, 9-33 
File Set Identifier 

See Fileset-ID 
File specification, 4-2 
File Structure Verificat 
Utility 
See VFY utility 
File Transfer Utility 

See FLX utility 
File type, 4-3 to 4-5 
File version number, 4-3 
Files-11, 5-4 
Fileset-ID, 5-12, 5-28, 

5-40 
Filespec, 4-2 to 4-3 
FIX command, 7-35 to 7-3 
Flag 
status 

task, 7-48 
Floating qualifier, 1-3 
FLX utility, 5-12 
FMT utility, 5-10, 5-12 
FOREIGN qualifier 

MOUNT command, 5-9 to 
5-12 to 5-13, 5-26 
Foreign volume, 5-9 to 5 

5-12 to 5-13, 5-26, 
FORTRAN command, 6-2, 6- 

6-20, 9-16 
FORTRAN IV, 6-13 to 6-20 
FORTRAN IV-PLUS, 6-13 to 

9-16 
FORTRAN-77, 6-13 to 6-20 



9, 4-79 
5-51, 



to 4-3 
ion 



5-38 to 



7, 9-16 



to 1-5 



5-10, 
, 5-29 
-10, 
5-29 
13 to 

, 9-16 
6-20, 

, 9-16 



Global event flags 

group, 6-91 to 6-92, 9-32, 
9-38 
Group global event flags, 6-91 
to 6-92, 9-32, 9-38 

HELP command, 1-5 to 1-6, 3-22 
to 3-28, 9-17 

format, 3-28 

writing, 3-28 
HELP file 

format, 3-26 to 3-27 

writing, 3-26 to 3-27 
HOLD qualifier 

LOGOUT command, 3-7 
HOLD/ENTRY command, 9-17 
HOLD/JOB command, 9-18 
HOLD_SCREEN qualifier 

SET TERMINAL command, 3-14, 
3-19 
Home block 

volume, 5-11, 5-47 to 5-59, 
9-18, 9-20 
HOME utility, 5-57 to 5-59, 

9-20 
Hyphen (-) , 3-16 
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INDEXF.SYS file, 5-11, 5-65 to 

5-66 
Indirect command file operator 

(@) , 3-16 
Indirect command file processor, 

1-17 
INITIALIZE command, 5-4, 5-10, 

5-12, 5-47 to 5-56, 9-18 
INITIALIZE/PROCESSOR command, 

9-19 
INITIALIZE/QUEUE command, 9-20 
INITIALIZE/UPDATE command, 5-11, 

5-57 to 5-59, 9-20 
INSTALL command, 7-1, 7-4 to 

7-8, 7-12 to 7-15, 7-26 to 

7-34, 7-60, 9-20, 9-37 
Installed task, 7-57 to 7-58 
Interpreter 

BASIC-11, 6-2, 6-11 to 6-13 

Key 

ALT MODE, 3-12 
BACK SPACE, 3-13 
CAPS LOCK, 3-14 
COPY, 3-14 
CTRL, 3-18 

cursor-control, 3-17 
DELETE, 3-13 
ENTER, 3-12, 3-17 
ESC, 3-12 
ESCAPE, 3-12 
LINE PEED, 3-13 
kin ccTsnr r o_i * 

REPEAT, 3-14 

RETURN, 3-2, 3-12, 3-17, 3-22 

SCROLL, 3-14 

SEL, 3-12 

SHIFT, 3-14 

TAB, 3-22 
Keyboard 

terminal, 3-1, 3-11 
Keypad 

terminal, 3-1, 3-17 
Keypad Editor 

See also Editor, K52 and 
Editor, KED 

LA36, 3-1, 3-14 
Label 

volume, 5-28 
Labeled magtape volume, 5-4, 

5-35 to 5-36 
Language 

source, 6-2 

support, 6-2 
LB: 

pseudo device, 5-6 
LBR, 6-39 to 6-61 

See also LIBRARY command 
Librarian Utility 

See LBR 
Library 

macro, 6-4i 



Library (Cont.) 

object module, 6-41 
shareable, 6-73 
universal, 6-41 
LIBRARY command, 6-39 to 6-61, 

9-21 
Library directory, 6-41, 7-7 to 

7-9, 7-27, 8-4 to 8-5, 8-7, 

9-32, 9-38 
LIBRARY/COMPRESS command, 6-42 

to 6-43, 9-21 
LIBRARY/CREATE command, 6-43 to 

6-46, 9-21 
LIBRARY/DELETE command, 6-46 to 

6-47, 9-22 
LIBRARY/EXTRACT command, 6-47 

to 6-48, 9-22 
LIBRARY/INSERT command, 6-48 to 

6-50, 9-22 
LIBRARY/LIST command, 6-50 to 

6-53, 9-23 
LIBRARY/REMOVE command, 6-54, 

9-23 
LIBRARY/REPLACE command, 6-54 

to 6-56, 9-23 
Lins confcin us t i o x\ 
DCL, 1-11, 3-12 
LINE PEED key, 3-13 
Line Text Editor 
See EDI editor 
LINK command, 6-1, 6-62 to 6-89, 

7-4, 9-23 to 9-25 

T T»1W //-»Ot *» _— — — _ J /" M J f~ r\ f\ 

l.xhi\/»-01 V* UUUli CI J 1U , O — O / UU 0"03/ 

9-25 
LINK/COBOL command, 6-87 to 

6-89, 9-25 
Locked file, 4-75 to 4-76, 9-47 
Logging in, 3-2, 4-2 
Logging out, 3-2 
Logical name, 5-5, 5-8, 5-13 to 

5-15 
Logical Unit Number 

See LUN 
Logical unit table, 5-8, 5-18 

to 5-19 
LOGIN command, 3-3 to 3-6, 3-9 

to 3-10, 9-25 
L0GIN.CMD file, 3-4 
L0GIN.TXT file, 3-4 
LOGOUT command, 3-7 to 3-8, 

5-13, 5-45, 9-25 
LUN, 5-5, 5-7, 5-18 to 5-19, 

7-57 to 7-58 

MACRO command, 6-2 to 6-11, 

9-26 
Macro library, 6-41 
MACRO-11 Assembler, 6-2 to 6-11, 

9-26, B-2 
Magnetic tape 
See Magtape 
Magnetic Tape ACP 
See MTAACP 
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Magtape, 1-10, 5-4, 5-12, 5-27 

ANSI, 5-4, 5-34 to 5-36 

mounting, 5-38 to 5-40 
Magtape ACP 

See MTAACP 
Magtape volume 

ANSI, 5-4, 5-34 to 5-36 

labeled, 1-10, 5-4, 5-12, 
5-35 to 5-36 

unlabeled, 5-4, 5-35 to 5-36 
Master File Directory 

See MFD 
MCR, 1-1 to i-2, B-i 
MCR command, 1-7, 9-25 
MERGE 

See CONVERT command 
Message 

error, A-l 
MFD, 4-1, 5-11, 5-65 
MK: 

pseudo device, 5-6 
Monitor Console Routine 

See MCR 
MOUNT command, 5-4, 5-9, 5-12 

to 5-13, 5-26 to 5-42, 9-27 
to 9-28 
Mounted volume, 5-9, 5-13 
MTAACP, 5-34, 5-38 to 5-40 
Multiuser task, 6-73 
MUNG qualifier 

EDIT command, 4-20 to 4-22, 
9-16 

NL: 

pseudo device, 5-6 
NO SCROLL key, 3-14 
Number 

version 
file, 4-3 
Number sign (#) , 3-16 

Object module library, 6-41 
ODT, 6-90 to 6-91 
OPTIONS qualifier 

LINK command, 6-63, 6-74 to 
6-79, 6-86 

Parameter 

DCL, 1-8 
Partition, 7-38 to 7-45, 9-32 
Password, 3-3 to 3-4 

4-8 
Peripheral device, 5-1 
Peripheral Interchange Program 

See PIP utility 
Physical device, 5-1 to 5-3, 

5-5, 5-8 
PIP, B-l 

PIP utility, 1-17 
PRINT command, 4-52 to 4-61, 

9-28 to 9-29 
Priority, 7-59 to 7-60, 9-33 



Private device, 5-9, 5-13, 5-22 

to 5-25 
Prompt, 1-3, 3-15 
Protection 

file, 2-6, 4-79 to 4-82, 5-28, 

5-38, 5-51, 5-58, 9-33 
volume, 5-31, 5-38, 5-52, 
5-58 
Pseudo device, 5-1 to 5-8 
CL:, 5-6 
CO:, 5-6 
LB:, 5-6 
MK:, 5-6 
NL:, 5-6 
RD:, 5-6 
SP:, 5-6 
SY:, 4-2, 4-77 to 4-79, 5-6, 

5-72 to 5-73, 9-31 
TI:, 5-7 
VT:, 5-6 
WK:, 5-6 
Public device, 5-9, 5-13, 5-75 
PURGE command, 4-34 to 4-37, 
9-29 

QMG, 1-16, 4-52, 9-44, 9-46, 

B-l 
Qualifier 

DCL, 1-3 to 1-5 

floating, 1-3 to 1-5 
Queue 

clock, 7-12 to 7-15, 7-23, 
7-60, 9-37 
Queue Manager 

See QMG 

Radix-50, A-l 
RD: 

pseudo device, 5-6 
Ready-to-run task, 7-1 
Record Management Services-11 

See RMS-11 
Redirection, 5-16 to 5-18 
RELEASE/ENTRY command, 9-29 
RELEASE/JOB command, 9-29 
REMOVE command, 7-34 to 7-35, 

9-29 
RENAME command, 4-41 to 4-43, 

9-30 
REPEAT key, 3-14 
REQUEST command, 3-32, 9-30 
Resident common. 7-61, 9-37 
Resource Accounting, 3-2, 3-9 

to 3-11, 9-36 
Resource Monitoring Display 

See RMD 
RETURN key, 3-2, 3-12, 3-17, 

3-22 
Right-angle bracket, 3-15 
RMD, 7-53, 7-55 to 7-57, 8-9 to 

8-13, 9-38 
RMS-11, 4-22, 4-43 to 4-49, B-l 
RMSCNV, 4-43 to 4-49, B-l 
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RMSMAG.MLB, 6-41 
RSX-11M/M-PLUS DCL, 1-19 
RSXMAC.SML file, 6-41 
RUN command, 7-1, 7-4 to 7-16, 
7-26, 7-60, 9-30, 9-37 

Scheduling 

task, 7-12 to 7-15, 7-60, 
9-30, 9-37 
Scratch disk, 5-10 to 5-11 
SCROLL key, 3-14 
SEL key, 3-12 
SET DAYTIME command, 2-1, 8-1, 

9-31 
SET DEBUG command, 1-2, 1-12 to 

1-13, 2-7 
SET DEFAULT command, 2-4, 4-77 

to 4-78, 5-72 to 5-73, 9-31 
SET DEVICE command, 5-9, 5-74 

to 5-76, 9-31 
SET GROUPFLAGS command, 6-91 to 

6-92, 9-32 
SET LIBRARY/DIRECTORY command, 

2-7, 8-4, 9-32 
SET NODEBUG command, 1-2, 1-12 

to 1-13, 2-7 
SET NOPARTITION command, 7-38 

to 7-43, 9-32 
SET PARTITION command, 7-38 to 

7-43, 9-32 
SET PRIORITY command, 7-59 to 

7-60, 9-33 
SET PROTECTION command, 2-6, 

4-79 to 4-82, 9-33 
SET QUEUE/ENTRY command, 9-33 
SET QUEUE/JOB command, 9-34 
SET SYSTEM command, 8-3 to 8-4, 

9-34 
SET SYSTEM/DIRECTORY command, 

2-6 
SET TERMINAL command, 2-2 to 

2-3, 3-33 to 3-42, 9-35 
SET TERMINAL 'HOLD SCREEN 

command, 3-147 3-19 
SET TIME command, 2-1, 8-1, 

9-31 
Shareable common, 6-73 
Shareable device, 5-9, 5-13 
Shareable library, 6-73 
Shareable task, 6-73 
Shareable volume, 5-31, 5-38 
Shared device, 5-13 
SHIFT key, 3-14 
Short forms 

DCL, 1-7 to 1-8, 9-1 
SHOW ACCOUNTING command, 3-9 
SHOW ACCOUNTING/INFORMATION 

command, 9-36 
SHOW ASSIGNMENTS command, 2-4, 

5-72 to 5-73, 9-36 
SHOW CLOCK_QUEUE command, 7-60, 

9-37 
SHOW COMMON command 7-61 9-37 



SHOW DAYTIME command, 2-1 to 

2-2, 8-2, 9-37 
SHOW DEFAULT command, 2-4, 3-2, 

4-79, 9-37 
SHOW DEVICES command, 2-3, 5-4, 

5-77 to 5-80, 9-37 
SHOW GROUPFLAGS command, 6-92, 

9-38 
SHOW LIBRARY command, 8-7 
SHOW LIBRARY/DIRECTORY command, 

2-7, 9-38 
SHOW MEMORY command, 2-2, 8-9 

to 8-13, 9-38 
SHOW PARTITIONS command, 7-43 

to 7-45, 9-38 
SHOW PROCESSOR command, 2-4, 

9-39 
SHOW QUEUE command, 2-3 to 2-4, 

9-39 
SHOW QUEUE/FULL command, 2-4 
SHOW SYSTEM command, 8-5 to 8-7, 

9-40 
SHOW SYSTEM/DIRECTORY command, 

2-7 
SHOW TASK command, 9-40 
SHOW TASK/LOG I CAL_UN ITS command, 

7-57 to 7-58 
SHOW TASK:taskname/DYNAMIC 

command, 7-53 to 7-54, 9-40 
SHOW TASKS, 7-45 
SHOW TASKS command, 2-5 
SHOW TASKS/ACTIVE command, 2-5, 

3-2. 7-46 to 7-50. 9-40 
SHOW TASKS/ACTIVE/DYNAMIC 

command, 7-55 to 7-57, 9-40 
SHOW TASKS/INSTALLED command, 

2-5, 7-51 to 7-53, 9-40 
SHOW TERMINAL command, 2-2 to 

2-3, 3-43 to 3-54, 9-41 to 

9-42 
SHOW TIME command, 2-1 to 2-2, 

8-2, 9-37 

C ITAI.I ITO mt^k «-» J *t .- rt « 

ijnun uonr\o <juuiuicijiO r ^ — D , O — / CO 

8-8, 9-42 
Slash (/), 3-17 
Slave terminal, 3-41 
SLIPR 

See SLP utility 
Slow Task Builder, 6-81 
SLP utility, 4-17 to 4-19, 9-15 
Son of Stopgap 

See SOS editor 
SORT command, 4-63 to 4-69, 

9-42 
SORT-11, 4-63 to 4-69, 9-42 
SOS editor, 4-20 to 4-22, 9-16 
Source language, 6-2 
Source Language Input Program 

See SLP utility 
SP: 

pseudo device, 5-6 
SQUEEZE qualifier 

T TDnnriv ^ „„.„,-, v*J C _ A "» 
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START command, 7-25, 9-43 
START/PROCESSOR command, 9-43 
START/QUEUE command, 9-44 
START/QUEUE/MANAGER command, 

9-44 
START/UNBLOCK command, 7-25 to 

7-26, 9-44 
Status flag 

task, 7-48 
STD, 7-1 to 7-2, 7-26 to 7-34, 

7-51 to 7-53, 9-29 
STOP/ABORT command, 9-44 
STOP/BLOCK command, 7-2 3 to 

7-24, 9-45 
STOP/PROCESSOR command, 9-45 
STOP/QUEUE command, 9-45 
STOP/QUEUE/MANAGER command, 

9-46 
Stopped task, 7-25 
SUBMIT command, 9-46 
Subpartition, 7-38, 7-40 to 

7-45, 9-32 
SY: 

pseudo device, 4-2, 4-77 to 
4-79, 5-6, 5-72 to 5-73, 
9-31 
SYSLIB.OLB file, 6-40, 6-81 
SYSLOGIN.CMD file, 3-4 
System date, 2-1, 8-1 to 8-2, 

9-31, 9-37 
System directory, 6-41, 7-7 to 

7-9, 7-27, 8-5 
System library, 8-4 
System Task Directory 

See STD 
System time, 2-1, 8-1 to 8-2, 

9-31, 9-37 



Tab 

Vertical, 3-22 
TAB key, 3-22 
Tape set 

mounting, 5-38 to 5-40 
Task, 7-1 

active, 7-1, 7-55 to 7-57 

blocked, 7-23 to 7-26, 9-44 

dormant, 7-1 

installed, 7-57 to 7-58 

multiuser, 6-73 

name, 7-2 to 7-3, 7-5 
RSX-11M, 7-4 
RSX-11M-PLUS, 7-5 

ready-to-run, 7-1 

scheduling, 7-12 to 7-15, 
7-60, 9-30, 9-37 

shareable, 6-73 

state, 7-1 

stopped, 7-25, 9-43 
Task Builder, 9-23 to 9-24 

See TKB 
Task status flag, 7-48 



Task Termination Notification 
program 
See TKTN 
Task-build, 6-1, 6-62 to 6-86, 

6-88 to 6-89 
Technical changes 

RSX-11M-PLUS, C-l 
TECO editor, 4-21 to 4-22, 9-16 
Terminal 

attached, 3-2 

attributes, 2-2 to 2-3, 3-2, 

3-33 to 3-54, 9-35 
characteristics, 2-2 to 2-3, 

3-2, 3-33 to 3-54, 9-35 
model, 2-2 to 2-3, 3-2, 3-33 

to 3-54, 9-35 
number, 3-1 
slave, 3-41 
slaved, 3-2 
Terminal keyboard, 3-1, 3-11 
Terminal keypad, 3-1, 3-17 
Text Editor and Corrector 

See TECO editor 
TI: 

Pseudo device, 5-6 
Time 

system, 2-1, 8-1 to 8-2, 9-31, 
9-37 
TKB, 6-1, 6-62 to 6-89, B-2 

options, 6-76 to 6-79, 6-86 
TKTN, 7-19 to 7-21 
TYPE command, 4-50 to 4-52, 
9-46 



UFD, 4-1, 5-11, 5-65 
creating, 4-11 
default, 4-3, 4-77 to 4-79; 
5-72, 9-31 
UIC, 3-3 to 3-4, 4-2 
Underscore (_) , 1-9, 3-16 
UNFIX command, 7-37 to 7-38, 

9-47 
Universal library, 6-41 
Unlabeled magtape volume, 5-4, 

5-35 to 5-36 
UNLOCK command, 4-75 to 4-76, 

9-47 
Unowned device, 5-9, 5-13 
User File Directory 

See UFD 
User Identification Code 

See UIC 
User name, 3-3 to 3-4 
Utilities, 1-17 to 1-19, B-l 



VAX/VMS DCL, 1-19 
Version number 

file, 4-3 
Vertical tab, 3-22 
VFY utility, 5-12 
VMLIB.OLB file, 6-40 
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Volume, 4-1, 5-3 to 5-4, 5-26 Volume Identifier 
to 5-27, 5-29 to 5-42 See Volume-ID 

disk, 5-3 to 5-4, 5-38 Volume label, 5-28 

foreign, 5-9 to 5-10, 5-12 to Volume protection, 5-38, 5-52, 

5-13, 5-26, 5-29 5-58 

magtape Volume-ID, 5-38 to 5-40 

labeled, 5-4, 5-35 to 5-36 VT100, 3-1, 3-14 

unlabeled, 5-4, 5-35 to VT52, 3-1, 3-14, 3-18 

5-36 VT: 
mounted, 5-9, 5-13 pseudo device, 5-6 

protection, 4-9 

shareable, 5-31, 5-38 Wildcard, 3-16, 4-6 to 4-8 

Volume Home Block, 5-11, 5-47 WK: 

to 5-59, 9-18, 9-20 pseudo device, 5-6 
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READER'S COMMENTS 



NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
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